Skip to main content

Getting Started

[Scala Native] Build All Release GitHub Release

Hits

What is ai-skills?​

ai-skills is a native CLI tool for managing reusable prompt skills for AI coding agents. It can install and manage AI agent skills (SKILL.md) and provides commands to install, list, read, update, sync, and remove skills across project-local and global directories for multiple AI agents.

Built with Scala 3 and Scala Native, it compiles to a standalone binary with no JVM or Node.js runtime required.

Why ai-skills?​

AI coding agents like Claude, Cursor, Codex, Gemini, Windsurf, and Copilot each support skills (reusable prompt instructions), but they store them in different directories. ai-skills gives you a single tool to:

  • Install skills from GitHub repos, Git URLs, or local directories
  • Sync skills across multiple agents with one command
  • Update all your skills from their original sources
  • Manage skills consistently across project and global scopes

Installation​

Install ai-skills​

Install directly (taps automatically) [Recommended]:

brew install kevin-lee/tap/ai-skills

Or tap first, then install:

brew tap kevin-lee/tap
brew install ai-skills

Update ai-skills​

If it's already installed and you want to update to the latest version,

brew update && brew upgrade ai-skills

Verify the installation:

aiskills --version
2.2.0

Interactive Mode — The Recommended Way​

Most ai-skills commands support interactive mode — just run the command without any flags and you'll be guided through each step with prompts. This is the recommended way to use ai-skills, as you don't need to memorise any flags or parameters.

aiskills install owner/repo   # Prompts for agent(s) and location
aiskills list                 # Prompts for scope and agent(s)
aiskills read                 # Prompts for scope, agent(s), and skill(s)
aiskills sync                 # Guided wizard for source/target selection
aiskills remove               # Prompts for scope, agent(s), and skill(s)

For scripting and CI/CD, non-interactive mode is also available — see each command's documentation for the full set of flags.

Quick Start​

1. Install skills from a GitHub repo​

aiskills install owner/repo

An interactive prompt lets you choose which agent(s) and location (project or global) to install to.

e.g.) Install skills from Anthropic's Claude repo:

aiskills install anthropic/claude-skills

2. List installed skills​

aiskills list

3. Read a skill​

Interactive Mode:

aiskills read

Non-Interactive Mode:

aiskills read skill-name --agent claude --project

This outputs the skill content to stdout, intended for AI agents to consume.

4. Update all skills​

aiskills update

Re-fetches skills from their original source.

5. Sync skills between agents​

Interactive Mode:

aiskills sync

Non-Interactive Mode:

aiskills sync --from project:claude --to cursor --project

Copies skills from one agent's directory to another.

6. Remove a skill​

aiskills remove

Opens an interactive prompt to select skills for removal.