Skills CLI

Use bunx skills commands to manage skills.

Workflow

1. Inspect current state with bunx skills list (and bunx skills list -g for global).
2. Use bunx skills find <query> or bunx skills add <source> --list to discover options.
3. Install with explicit scope and agent targeting:
   • Global personal setup: -g -a codex -a claude-code
   • Project setup: omit -g
4. Verify install with bunx skills list and test a prompt that should trigger the skill.
5. For updates, run bunx skills check then bunx skills update.
6. For cleanup, use bunx skills remove ... with matching scope/agent flags.

Key commands

• bunx skills add <package-or-url>
• bunx skills add <source> --skill <name> -a <agent> [-g] -y
• bunx skills add <source> --all
• bunx skills list [-g] [-a <agent>]
• bunx skills find [query]
• bunx skills remove [skill...] [-g] [-a <agent>]
• bunx skills check
• bunx skills update
• bunx skills init [name]
• bunx skills experimental_install
• bunx skills experimental_sync

Guardrails

• Prefer explicit --agent and --skill flags for reproducibility.
• Use --yes only for non-interactive runs.
• Default to symlink mode unless the user requests --copy.
• Treat installed skills as executable instructions; avoid untrusted sources.
• If managing dotfiles with chezmoi, avoid chezmoi add on live skills directories.

References

Read references/cli.md for source formats, scopes, and practical command recipes.