Portable coding agent skills, distributed via the skills CLI.

npx skills add shoichiaizawa/skills -a claude-code -g -y

To install a single skill:

npx skills add shoichiaizawa/skills -s commit -a claude-code -g -y

The CLI supports many coding agents. Use -a to target one or more:

# Single agent
npx skills add shoichiaizawa/skills -a claude-code -g -y

# Multiple agents
npx skills add shoichiaizawa/skills -a claude-code cursor opencode -g -y

# All detected agents
npx skills add shoichiaizawa/skills -a '*' -g -y

Skills are stored once in a canonical location (~/.agents/skills/<name>/) and symlinked into each agent's directory. Some agents — including Cursor, Codex, Gemini CLI, GitHub Copilot, and OpenCode — read directly from ~/.agents/skills/ (no symlink needed). Others — including Claude Code, Cline, and Kiro — use their own directories (e.g. ~/.claude/skills/<name>/) with symlinks back to the canonical copy.

If you use multiple Claude accounts — for example, a personal Max Plan and an employer-provided Team or Enterprise Plan — you can separate each environment by pointing CLAUDE_CONFIG_DIR to a different directory per profile.

# Personal (default ~/.claude config directory)
npx skills add shoichiaizawa/skills -a claude-code -g -y

# Work (separate config directory)
CLAUDE_CONFIG_DIR=~/.claude-work npx skills add shoichiaizawa/skills -a claude-code -g -y

# Or from within a Claude Code session, prefix with ! to run as a shell command
# ! npx skills add shoichiaizawa/skills -a claude-code -g -y

To launch Claude Code under a non-default profile, set the same variable:

CLAUDE_CONFIG_DIR=~/.claude-work claude

Shell aliases make this convenient — add them to ~/.bashrc or ~/.zshrc:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
alias claude-side='CLAUDE_CONFIG_DIR=~/.claude-side claude'

Each profile is fully independent.

Other environment variables: CODEX_HOME (Codex), XDG_CONFIG_HOME (OpenCode, Goose, Amp, and others).

# Check for updates
npx skills check

# Apply updates
npx skills update

Note: update does a full reinstall — local modifications to installed skill files will be overwritten.

# Interactive selection
npx skills remove -g

# Remove a specific skill
npx skills remove commit -g

# List installed skills
npx skills list -g

# Preview available skills without installing
npx skills add shoichiaizawa/skills -l

skills/
├── commit/
│   ├── SKILL.md
│   ├── scripts/
│   │   ├── analyse-changes.sh
│   │   ├── effort-level.sh
│   │   ├── pre-flight.sh
│   │   └── validate-message.sh
│   └── references/
│       └── message-format.md
└── parallel/
    ├── SKILL.md
    └── scripts/
        ├── cleanup.sh
        ├── launch.sh
        ├── merge.sh
        └── status.sh

The CLI discovers skills by scanning the skills/ directory for subdirectories containing a SKILL.md file.

Each skill requires YAML frontmatter with name and description:

---
name: my-skill
description: Brief explanation of what this skill does.
---

# /my-skill

Instructions for the agent.