🤹 skillman

Manage project Agent skills from skills.json. Uses skills CLI under the hood.

Usage

Install all skills from skills.json:

npx skillman

Add new skills to project:

npx skillman add skills.sh/vercel-labs/skills/find-skills

npx skillman add anthropics/skills:skill-creator

This creates a skills.json file:

{
  "$schema": "https://unpkg.com/skillman/skills_schema.json",
  "skills": [
    { "source": "vercel-labs/skills", "skills": ["find-skills"] },
    { "source": "anthropics/skills", "skills": ["skill-creator"] }
  ]
}

CLI Usage

npx skillman                    # Install skills from skills.json (default)
npx skillman install, i         # Same as above
npx skillman add <source>...    # Add skill source(s) to skills.json

Commands

install (default)

Installs all skills defined in skills.json.

npx skillman install [options]

| Option | Description | | ---------------- | ------------------------------------------------- | | --agent <name> | Target agent (default: claude-code, repeatable) | | -g, --global | Install skills globally | | -h, --help | Show help |

add

Adds skill source(s) to skills.json and installs them.

npx skillman add <source>... [options]

| Option | Description | | ---------------- | ------------------------------------------------- | | --agent <name> | Target agent (default: claude-code, repeatable) | | -h, --help | Show help |

Source Formats

Sources can be specified in multiple formats:

# GitHub owner/repo format
npx skillman add vercel-labs/skills

# skills.sh URL
npx skillman add https://skills.sh/vercel-labs/skills/find-skills
npx skillman add skills.sh/vercel-labs/skills/find-skills


# Multiple sources
npx skillman add org/repo-a:skill1 org/repo-b:skill2

# Specify skills (comma separated)
npx skillman add vercel-labs/agent-skills:vercel-deploy,vercel-react-native-skills

Examples

# Install all skills from skills.json
npx skillman

# Add a skill source (all skills)
npx skillman add vercel-labs/skills

# Add specific skills from a source
npx skillman add vercel-labs/agent-skills:vercel-deploy,vercel-react-native-skills

# Add from skills.sh URL
npx skillman add https://skills.sh/vercel-labs/skills/find-skills

# Install skills globally
npx skillman install --global

# Install for multiple agents
npx skillman install --agent claude-code --agent cursor

Development

🤖 Are you a robot? Read AGENTS.md.

• Clone this repository
• Install latest LTS version of Node.js
• Enable Corepack using corepack enable
• Install dependencies using pnpm install
• Run interactive tests using pnpm dev

Alternatives

• Proposal PR for adding skill-lock.json (vercel-labs/skills#234)
• Proposal PR for adding .skills (vercel-labs/skills#134)
• hairyf/skills-manifest

License

Published under the MIT license 💛.