Skip to main content
The Skills CLI supports over 40 coding agents. Each agent can install skills to project-level and/or global directories.

​
Agent Detection

The CLI automatically detects which coding agents you have installed by checking for their configuration directories. If no agents are detected, you’ll be prompted to select which agents to install skills for.

​
All Supported Agents

The following agents support the Skills CLI. The table shows the --agent flag value, project and global installation paths, and other key details.
Project paths are relative to your current directory. Global paths are typically in your home directory (~).

​
Complete Agent List

Agent--agent FlagProject PathGlobal PathDetection Path
OpenCodeopencode.agents/skills/~/.config/opencode/skills/~/.config/opencode
Claude Codeclaude-code.claude/skills/~/.claude/skills/~/.claude/
Codexcodex.agents/skills/~/.codex/skills/~/.codex/ or /etc/codex
Cursorcursor.agents/skills/~/.cursor/skills/~/.cursor/
Clinecline.agents/skills/~/.agents/skills/~/.cline/
OpenHandsopenhands.openhands/skills/~/.openhands/skills/~/.openhands/
Roo Coderoo.roo/skills/~/.roo/skills/~/.roo/
Windsurfwindsurf.windsurf/skills/~/.codeium/windsurf/skills/~/.codeium/windsurf/
Goosegoose.goose/skills/~/.config/goose/skills/~/.config/goose/
Continuecontinue.continue/skills/~/.continue/skills/./.continue/ or ~/.continue/
Ampamp.agents/skills/~/.config/agents/skills/~/.config/amp
Kimi Code CLIkimi-cli.agents/skills/~/.config/agents/skills/~/.kimi
Replitreplit.agents/skills/~/.config/agents/skills/./.replit
Antigravityantigravity.agent/skills/~/.gemini/antigravity/skills/~/.gemini/antigravity
Augmentaugment.augment/skills/~/.augment/skills/~/.augment
OpenClawopenclawskills/~/.openclaw/skills/~/.openclaw, ~/.clawdbot, or ~/.moltbot
CodeBuddycodebuddy.codebuddy/skills/~/.codebuddy/skills/./.codebuddy/ or ~/.codebuddy/
Command Codecommand-code.commandcode/skills/~/.commandcode/skills/~/.commandcode/
Cortex Codecortex.cortex/skills/~/.snowflake/cortex/skills/~/.snowflake/cortex/
Crushcrush.crush/skills/~/.config/crush/skills/~/.config/crush/
Droiddroid.factory/skills/~/.factory/skills/~/.factory/
Gemini CLIgemini-cli.agents/skills/~/.gemini/skills/~/.gemini/
GitHub Copilotgithub-copilot.agents/skills/~/.copilot/skills/~/.copilot/
Juniejunie.junie/skills/~/.junie/skills/~/.junie/
iFlow CLIiflow-cli.iflow/skills/~/.iflow/skills/~/.iflow/
Kilo Codekilo.kilocode/skills/~/.kilocode/skills/~/.kilocode/
Kiro CLIkiro-cli.kiro/skills/~/.kiro/skills/~/.kiro/
Kodekode.kode/skills/~/.kode/skills/~/.kode/
MCPJammcpjam.mcpjam/skills/~/.mcpjam/skills/~/.mcpjam/
Mistral Vibemistral-vibe.vibe/skills/~/.vibe/skills/~/.vibe/
Muxmux.mux/skills/~/.mux/skills/~/.mux/
Pipi.pi/skills/~/.pi/agent/skills/~/.pi/agent
Qoderqoder.qoder/skills/~/.qoder/skills/~/.qoder/
Qwen Codeqwen-code.qwen/skills/~/.qwen/skills/~/.qwen/
Traetrae.trae/skills/~/.trae/skills/~/.trae/
Trae CNtrae-cn.trae/skills/~/.trae-cn/skills/~/.trae-cn/
Zencoderzencoder.zencoder/skills/~/.zencoder/skills/~/.zencoder/
Neovateneovate.neovate/skills/~/.neovate/skills/~/.neovate/
Pochipochi.pochi/skills/~/.pochi/skills/~/.pochi/
AdaLadal.adal/skills/~/.adal/skills/~/.adal/
Universaluniversal.agents/skills/~/.config/agents/skills/Never detected (manual only)

​
Universal Agents

Some agents natively use the .agents/skills/ directory, which eliminates the need for symlinks in project installations:
  • OpenCode
  • Codex
  • Cursor
  • Cline
  • Amp
  • Kimi Code CLI
  • Gemini CLI
  • GitHub Copilot
For these agents, skills installed to the project are placed directly in .agents/skills/ with no additional symlinks needed.

​
Installing to Specific Agents

Use the --agent or -a flag to target specific agents: 
# Install to Claude Code only
npx skills add vercel-labs/agent-skills -a claude-code

# Install to multiple agents
npx skills add vercel-labs/agent-skills -a claude-code -a cursor

# Install to all agents
npx skills add vercel-labs/agent-skills --agent '*'

​
Feature Compatibility

While skills follow a shared Agent Skills specification, some advanced features are agent-specific:
FeatureOpenCodeOpenHandsClaude CodeClineCodeBuddyCodexCommand CodeKiro CLICursorAntigravityRoo CodeGitHub CopilotAmpOpenClawNeovatePiQoderZencoder
Basic skills✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓
allowed-tools✓✓✓✓✓✓✓✗✓✓✓✓✓✓✓✓✓✗
context: fork✗✗✓✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗
Hooks✗✗✓✓✗✗✗✗✗✗✗✗✗✗✗✗✗✗

​
Feature Descriptions

Standard SKILL.md files with name, description, and instructions. Supported by all agents.
Frontmatter field that restricts which tools the agent can use when the skill is active. Helps enforce workflow constraints.Example:
---
name: my-skill
description: A skill with tool restrictions
allowed-tools: [read, write, bash]
---
Claude Code-specific feature that creates a forked conversation context. Useful for exploratory tasks that shouldn’t affect the main conversation.
Lifecycle hooks that run before/after skill activation. Currently supported by Claude Code and Cline.

​
Special Notes for Specific Agents

​
Kiro CLI

After installing skills with the Skills CLI, you must manually add them to your custom agent’s configuration: 
// .kiro/agents/<agent>.json
{
  "resources": [
    "skill://.kiro/skills/**/SKILL.md"
  ]
}

​
OpenClaw

OpenClaw has multiple legacy directory names. The CLI checks for:
  • ~/.openclaw (current)
  • ~/.clawdbot (legacy)
  • ~/.moltbot (legacy)

​
Codex

Codex can be configured with the CODEX_HOME environment variable. The CLI respects this configuration: 
export CODEX_HOME=/custom/path
npx skills add vercel-labs/agent-skills -g
# Skills installed to /custom/path/skills

​
Claude Code

Claude Code respects the CLAUDE_CONFIG_DIR environment variable: 
export CLAUDE_CONFIG_DIR=/custom/claude/config
npx skills add vercel-labs/agent-skills -g
# Skills installed to /custom/claude/config/skills
For agent-specific skill documentation:

​
Contributing

To add support for a new agent:
  1. Add the agent definition to src/agents.ts
  2. Run pnpm run -C scripts validate-agents.ts to validate
  3. Run pnpm run -C scripts sync-agents.ts to update README.md
  4. Submit a pull request
See the skills repository for contribution guidelines.

​
Next Steps

Installation Methods

Learn about symlink vs copy installation modes

Creating Skills

Create custom skills for your agent

Build docs developers (and LLMs) love

Get started for freeTalk to us