๐Ÿ“ฆ pi0 / skillman

๐Ÿคน Manage project skills and lock them in skills.json

โ˜… 170 stars โ‘‚ 4 forks ๐Ÿ‘ 170 watching โš–๏ธ MIT License
๐Ÿ“ฅ Clone https://github.com/pi0/skillman.git
HTTPS git clone https://github.com/pi0/skillman.git
SSH git clone git@github.com:pi0/skillman.git
CLI gh repo clone pi0/skillman
Pooya Parsa Pooya Parsa chore(release): v0.0.6 77d70bc 29 days ago ๐Ÿ“ History
๐Ÿ“‚ main View all commits โ†’
๐Ÿ“ .github
๐Ÿ“ assets
๐Ÿ“ src
๐Ÿ“ test
๐Ÿ“„ .editorconfig
๐Ÿ“„ .gitignore
๐Ÿ“„ .oxfmtrc.json
๐Ÿ“„ .oxlintrc.json
๐Ÿ“„ AGENTS.md
๐Ÿ“„ build.config.mjs
๐Ÿ“„ CHANGELOG.md
๐Ÿ“„ CLAUDE.md
๐Ÿ“„ LICENSE
๐Ÿ“„ package.json
๐Ÿ“„ pnpm-lock.yaml
๐Ÿ“„ README.md
๐Ÿ“„ renovate.json
๐Ÿ“„ skills_schema.json
๐Ÿ“„ skills.json
๐Ÿ“„ tsconfig.json
๐Ÿ“„ README.md

๐Ÿคน skillman

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

Usage

Install all skills from skills.json:

npx skillman

Install preview

Add new skills to project:

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

npx skillman add anthropics/skills:skill-creator

Install preview

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]

OptionDescription
--agent <name>Target agent (default: claude-code, repeatable)
-g, --globalInstall skills globally
-h, --helpShow help

add

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

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

OptionDescription
--agent <name>Target agent (default: claude-code, repeatable)
-h, --helpShow 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.

local development

  • 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

License

Published under the MIT license ๐Ÿ’›.