Install agent skills onto your coding agents from any git repository.

Supports Opencode, Claude Code, Codex, Cursor, and 11 more.

npx add-skill vercel-labs/agent-skills

Agent skills are reusable instruction sets that extend your coding agent's capabilities. They're defined in SKILL.md files with YAML frontmatter containing a name and description.

Skills let agents perform specialized tasks like:

• Generating release notes from git history
• Creating PRs following your team's conventions
• Integrating with external tools (Linear, Notion, etc.)

The <source> argument accepts multiple formats:

# GitHub shorthand
npx add-skill vercel-labs/agent-skills

# Full GitHub URL
npx add-skill https://github.com/vercel-labs/agent-skills

# Direct path to a skill in a repo
npx add-skill https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design

# GitLab URL
npx add-skill https://gitlab.com/org/repo

# Any git URL
npx add-skill git@github.com:vercel-labs/agent-skills.git

# List skills in a repository
npx add-skill vercel-labs/agent-skills --list

# Install multiple specific skills
npx add-skill vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# Install to specific agents
npx add-skill vercel-labs/agent-skills -a claude-code -a opencode

# Non-interactive installation (CI/CD friendly)
npx add-skill vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

# Install all skills from a repo
npx add-skill vercel-labs/agent-skills -y -g

Skills can be installed to any of these supported agents. Use -g, --global to install to the global path instead of project-level.

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

Skills are directories containing a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: What this skill does and when to use it
---

# My Skill

Instructions for the agent to follow when this skill is activated.

## When to Use

Describe the scenarios where this skill should be used.

## Steps

1. First, do this
2. Then, do that

• name: Unique identifier (lowercase, hyphens allowed)
• description: Brief explanation of what the skill does

The CLI searches for skills in these locations within a repository:

• Root directory (if it contains SKILL.md)
• skills/
• skills/.curated/
• skills/.experimental/
• skills/.system/
• .opencode/skill/
• .claude/skills/
• .codex/skills/
• .cursor/skills/
• .agents/skills/
• .kilocode/skills/
• .roo/skills/
• .goose/skills/
• .gemini/skills/
• .agent/skills/
• .github/skills/
• ./skills/
• .factory/skills/
• .windsurf/skills/

If no skills are found in standard locations, a recursive search is performed.

Skills are generally compatible across agents since they follow a shared Agent Skills specification. However, some features may be agent-specific:

Ensure the repository contains valid SKILL.md files with both name and description in the frontmatter.

• Verify the skill was installed to the correct path
• Check the agent's documentation for skill loading requirements
• Ensure the SKILL.md frontmatter is valid YAML

Ensure you have write access to the target directory.

• Vercel Agent Skills Repository
• Agent Skills Specification
• OpenCode Skills Documentation
• Claude Code Skills Documentation
• Codex Skills Documentation
• Cursor Skills Documentation
• Gemini CLI Skills Documentation
• Amp Skills Documentation
• Antigravity Skills Documentation
• GitHub Copilot Agent Skills
• Roo Code Skills Documentation
• Clawdbot Skills Documentation

MIT