capa add

Add skills from GitHub, GitLab, Git URLs, or local paths to your capabilities file.

Usage

capa add <source> [--id <custom-id>]

Description

Quickly add skills from various sources without manually editing the capabilities file. The command will fetch the skill and add it to your capabilities.yaml or capabilities.json file.

Arguments

<source>

The source of the skill to add. Can be one of:

  • GitHub: owner/repo@skill-name
  • GitHub skill URL: https://github.com/owner/repo/tree/main/skills/skill-name
  • GitLab: gitlab:group/repo@skill-name
  • GitLab skill URL: https://gitlab.com/group/repo/-/tree/main/skills/skill-name
  • Local path: ./path/to/skill (must contain SKILL.md)
  • Direct URL: https://example.com/path/to/SKILL.md

Note: For GitHub and GitLab repositories, you must specify the skill name using @skill-name syntax, as repositories can contain multiple skills.

Options

--id <custom-id>

Specify a custom ID for the skill. If not provided, CAPA will use the repository or directory name.

Examples

Add a Skill from GitHub

capa add vercel-labs/agent-skills@web-researcher

Add from GitHub with Custom ID

capa add vercel-labs/agent-skills@web-researcher --id my-custom-skill

Add from GitHub Skill URL

capa add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-researcher

Add from GitLab

capa add gitlab:mygroup/myrepo@my-skill

Add from GitLab Skill URL

capa add https://gitlab.com/mygroup/myrepo/-/tree/main/skills/my-skill

Add from Local Path

capa add ./my-skills/custom-skill

The local directory must contain a SKILL.md file.

Add from Direct URL

capa add https://example.com/my-skill/SKILL.md

How It Works

  1. CAPA fetches the skill from the specified source
  2. Parses the SKILL.md file to understand requirements
  3. Adds the skill entry to your capabilities file
  4. You still need to run capa install to actually install the skill

Skills.sh Ecosystem

The skills.sh ecosystem provides a collection of well-maintained skills for common agent tasks. Popular repositories include:

  • vercel-labs/agent-skills - Official collection of agent skills
  • Community-contributed skills on GitHub and GitLab

When installing from a skills repository, browse the repository's skills/ directory to find available skills, then use the @skill-name syntax to install a specific skill.

After Adding a Skill

After adding a skill, you may need to:

  1. Review the added skill in your capabilities file
  2. Add required tools and servers if not already present
  3. Run capa install to install the skill

Related Commands