SkillCLI

CLI-first skill runtime for discovering, installing, validating, routing, and emitting AI skills.

Install

Choose one of these three setups.

1. Global install from npm

Use this when you want skill available everywhere on your machine without cloning the repo.

npm i -g skill_cloud
skill --help

2. Local link for CLI development

Use this when you are actively editing skillcli/ and want the linked command to pick up local changes.

cd skillcli
npm link
skill --help

3. npx one-off run

Use this when you do not want a global install.

npx --yes skill_cloud --help
npx --yes skill_cloud index rebuild --skills-dir ./skills

If you are working from a checked-out repo before publishing, the local equivalents are:

npm i -g ./skillcli
npx --yes ./skillcli --help

Usage

After a global install or npm link, use the skill command directly:

# Rebuild the routing index from the canonical local skills/ directory
skill index rebuild --skills-dir ../skills

# Show the routing table from the local skills/ tree
skill index show --skills-dir ../skills

# Match a query to find the right skill
skill index match "validate my skill" --json --skills-dir ../skills

# Validate a single skill file
skill validate ../skills/lifecycle/skill-validator/skill.md

# Package an arbitrary GitHub repo into a skill scaffold
skill package https://github.com/user/repo --domain tools

# Create a new skill from scratch
skill init my-new-skill

Canonical skill file:

• skill.md with YAML frontmatter + Markdown body
• Legacy skill.yaml is still accepted as an install/import source

Implemented commands:

• skill init [name]
• skill validate [file] [--target openai]
• skill source add|list|remove <url-or-path>
• skill search <keyword> / skill info <name>
• skill install <skill-ref> [--input key=value] [--with-deps]
• skill list / skill uninstall <name> / skill update <name|--all>
• skill check-deps <name>
• skill emit <name> --target <claude-code|openai|anthropic-api> --out <dir>
• skill index rebuild|show [--json]
• skill index match "<query>" [--json] [--threshold 0.5] [--max 5] [--exclude a,b] [--loaded-domains finance,document]
• skill index deps <name> / skill index deps --all
• skill index validate
• skill index core --json
• skill index load <name> [--with-deps] --json
• skill index emit-hook --target claude-code --out <dir>
• skill adapter list|install
• skill doctor
• skill evolve add <entry>
• skill publish

skill-ref supports:

• name@version
• github:user/repo@hash
• local path (./skill.md, ./SKILL.md, ./skill.yaml)