Installation

The ai-skill CLI installs published context packs from ai-skill.dev into local AI IDE folders.

Install globally

npm i -g @ai-skill-dev/cli

Verify:

ai-skill --help

Use with npx

npx @ai-skill-dev/cli --help

Install a published context pack

Preferred command:

ai-skill install rb-testcontext

This fetches the published context pack named rb-testcontext from the registry and writes it into the selected target folder.

Interactive install

Run the command without a context-pack name:

ai-skill install

The CLI opens an interactive picker so a developer can select a published context pack from the registry.

Install with target

ai-skill install rb-testcontext --target cursor
ai-skill install rb-testcontext --target claude
ai-skill install rb-testcontext --target agents
ai-skill install rb-testcontext --target ai

For Windsurf and other tools without a dedicated adapter, use --target agents or --target ai until a specific adapter is added.

Local registry during development

When testing against a local dashboard:

ai-skill install rb-testcontext --registry http://localhost:3000

Private or organization context packs

Pass a token:

ai-skill install internal-frontend-rules --token YOUR_TOKEN

Or set an environment variable:

AI_SKILL_TOKEN=YOUR_TOKEN ai-skill install internal-frontend-rules

Update installed context packs

ai-skill update

Update one pack:

ai-skill update rb-testcontext

Validate local output

ai-skill validate rb-testcontext

Use validation to catch missing SKILL.md, invalid frontmatter, unsafe paths, or broken generated output.