skillbox

A collection of installable Claude / Agent skills, distributed via npm.

Each skill is a directory under skills/ containing a SKILL.md. Installing copies those directories into your skills folder (default ~/.claude/skills).

Install

No global install needed — run via npx:

# install every bundled skill into ~/.claude/skills
npx @shijie-li/skillbox install

# install specific skills
npx @shijie-li/skillbox install my-skill another-skill

# overwrite existing ones
npx @shijie-li/skillbox install --force

# install into a project-local skills dir instead
npx @shijie-li/skillbox install --dir ./.claude/skills

Other commands:

npx @shijie-li/skillbox list                 # list skills bundled in the package
npx @shijie-li/skillbox uninstall my-skill   # remove an installed skill
npx @shijie-li/skillbox help

The target directory can also be set with the CLAUDE_SKILLS_DIR env var.

Adding a skill

Drop a directory under skills/:

skills/
  my-skill/
    SKILL.md      # required: frontmatter (name, description) + instructions
    ...           # optional supporting files

name in the frontmatter should match the directory name. Only directories that contain a SKILL.md are treated as skills.

Publishing

This package is published under the scoped name @shijie-li/skillbox (the unscoped skillbox was already taken). Scoped packages are private by default, so the first publish and every release must pass --access public:

npm version patch                  # bump version
npm publish --access public        # publish to npm

License

MIT