Skillfold cli
Use skillfold to manage a project's Claude skills. Declare skills in skillfold.yaml, pin them in skillfold.lock, and install them into .claude/skills.From its SKILL.md
npx -y skills add byronxlg/skillfold --skill skillfold-cliAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 12 stars12 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 8 commands, including `skillfold init` and 7 more.
SKILL.md
2.5 KB, 563 tokens by cl100k_base, as published. Nobody here has run it
Skillfold CLI
You use skillfold, a declarative skill manager for Claude config. Projects declare the skills they use in skillfold.yaml; skillfold installs them into .claude/skills and pins exact revisions in skillfold.lock.
Manifest
skillfold.yaml at the project root:
skills:
commit-helper: ./skills/commit-helper # local directory
frontend-design: github:owner/repo/path/to/[email protected] # GitHub (tag, branch, or SHA)
planning: npm:skillfold/[email protected] # npm package
compose:
reviewer:
description: Review code changes together with their tests.
use: [code-review, testing]
A trailing @ref after the last / pins a version. Composed skills concatenate the bodies of the skills they use into one generated skill.
Commands
skillfold init # scaffold a starter manifest + example skill
skillfold add <source> # add a skill and install it (--name to rename)
skillfold remove <name> # remove a skill and uninstall it
skillfold install # install everything, write skillfold.lock
skillfold install --frozen # CI mode: exact lockfile install, fail on drift
skillfold update [name...] # re-resolve moving refs, then reinstall
skillfold check # verify manifest, lockfile, and installed files agree
skillfold list # status table (ok / modified / not installed / not locked)
skillfold info <name> # source, pin, hash, and install path for one skill
skillfold search [query] # find skill packages on npm
Add -g / --global to manage ~/.claude/skills instead of the project.
Rules
- Commit both
skillfold.yamlandskillfold.lock. Never edit the lockfile by hand. - To change a skill's version, edit its
@refin the manifest (or runskillfold update <name>), then runskillfold install. - Never edit files under
.claude/skillsfor managed skills; edit the source (local directory or upstream) and reinstall.skillfold listshowsmodifiedwhen installed files drifted. - If
checkfails in CI, the fix is almost alwaysskillfold installlocally and committing the resulting lockfile. - Use
skillfold add npm:<package>/<skill>for published skills; theskillfoldpackage itself ships general-purpose skills (planning, research, code-review, testing, and more).
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.