Skills Manager

Manage your agent skills repository. Save remote skills to a registry, clone skills to customize, or just install skills directly.

Commands

Command	Description
save <owner/repo> [skill]	Bookmark a skill in your registry
save <owner/repo> [skill] --install	Bookmark + install
unsave <skill-name>	Remove a skill from registry
clone <owner/repo> [skill]	Copy a skill to your skills/ directory to customize
add <owner/repo> [skill] [--global]	Install a skill (no tracking)
list	Show all saved skills
install	Install all saved skills from registry
setup [path]	Set up your agent-skills repository

Configuration

Skills-manager needs to know where your agent-skills repository is located.

Priority order:

1. $AGENT_SKILLS_REPO environment variable
2. config.json in the skill's directory

If neither is configured, you'll be prompted to run setup.

Setup Flow

When a user runs any command without configuration:

1. Check for $AGENT_SKILLS_REPO environment variable
2. Check for config.json in the skill's directory
3. If neither exists, prompt:

   No agent-skills repository configured.
   Would you like to create one?
   - Current directory: /path/to/current
   - Custom path: let me specify
   

4. Create the repository structure and save config

Scripts

Run scripts from the skill's directory:

# Get the skill directory (where this SKILL.md is located)
SKILL_DIR="$(dirname "$0")"

# Setup
$SKILL_DIR/scripts/setup.sh [path]

# Save a skill
$SKILL_DIR/scripts/save.sh owner/repo [skill-name] [--install]

# Unsave a skill
$SKILL_DIR/scripts/unsave.sh skill-name

# Clone a skill
$SKILL_DIR/scripts/clone.sh owner/repo [skill-name]

# Add/install a skill (passthrough to npx)
$SKILL_DIR/scripts/add.sh owner/repo [skill-name] [--global]

# List saved skills
$SKILL_DIR/scripts/list.sh

# Install all saved skills
$SKILL_DIR/scripts/install.sh

Registry Format

The skills-registry.json in your agent-skills repo:

{
  "skills": {
    "react-best-practices": {
      "source": "vercel-labs/agent-skills",
      "path": "skills/react-best-practices",
      "savedAt": "2025-01-21T00:00:00Z"
    }
  }
}

Repository Structure

When you run setup, this structure is created:

agent-skills/
├── skills-registry.json    # Your saved/bookmarked skills
├── skills/                  # Your authored + cloned skills
│   └── (cloned skills go here)
├── README.md
└── AGENTS.md

Workflow Examples

Save a skill for later:

> save vercel-labs/agent-skills react-best-practices
Saved 'react-best-practices' to registry.

Save and install immediately:

> save vercel-labs/agent-skills react-best-practices --install
Saved 'react-best-practices' to registry.
Installing...
Done!

Clone a skill to customize:

> clone vercel-labs/agent-skills react-best-practices
Cloned 'react-best-practices' to your skills/ directory.
You can now modify it as your own skill.

Install a skill without saving:

> add vercel-labs/agent-skills react-best-practices
Installing react-best-practices...
Done! (not saved to registry)

Install all saved skills (e.g., on a new machine):

> install skills from registry
Installing 5 saved skills...
✓ react-best-practices
✓ typescript-patterns
✓ testing-guidelines
...
Done!

For New Users

If you don't have an agent-skills repository yet, the skill will help you create one:

1. Run any command (e.g., "save a skill")
2. You'll be prompted to set up your repository
3. Choose a location (current directory or custom path)
4. The skill creates the structure and saves the config
5. Continue using the skill!