orbskills

CLI for managing reusable AI skill files across projects. Skills are installed as symlinks from this repo's skills/ directory into each project locally.

Usage

bunx orbskills <command>
# or
npx orbskills <command>

Commands

orbskills list                              # list available skills
orbskills install <skill-name>              # install a skill (all tools)
orbskills install <skill-name> --tool <tool-name>  # install for specific tool
orbskills install all                       # install everything
orbskills update                            # re-sync managed installs
orbskills remove <skill-name>               # remove a skill
orbskills doctor                            # inspect project setup

Install Paths

| Tool | Directory | | ------------- | ------------------------- | | universal | ./.agents/skills | | claude-code | ./.claude/skills | | state | ./.orbskills/state.json |

Universal covers: Amp, Antigravity, Cline, Codex, Cursor, Deep Agents, Gemini CLI, GitHub Copilot, Kimi Code CLI, OpenCode, Warp.

Skill Layout

skills/
  some-skill/
    skill.json    # manifest (name, title, description, version, entry)
    SKILL.md      # skill content

Environment Overrides

• ORB_SKILLS_HOME — state file directory
• ORB_SKILLS_UNIVERSAL_DIR — override universal install path
• ORB_SKILLS_CLAUDE_CODE_DIR — override claude-code install path

Development

bun install          # install deps
bun run build        # build CLI
bun run dev -- list  # run from source
bun run check        # full verification (format, lint, typecheck, test)
bun test             # tests only

Architecture

• src/cli.ts — entrypoint
• src/commands/* — command registration
• src/core/* — install, update, remove, registry, state
• src/tools/* — tool adapters
• src/utils/* — helpers
• skills/* — bundled skill definitions
• tests/* — unit tests