Install project skills

Project-local skills belong to the repository. The lockfile records their sources, and the committed .agents/skills/ and .claude/skills/ entries make them available in a fresh checkout.

If skills-lock.json has not changed and the user only wants to restore the committed skill directories, run:

pnpm skills:install

When adding, removing, renaming, or refreshing a lockfile entry, read [the skill list change instructions](./catalog-change.md). They define the order of work, the check for skills renamed or removed upstream, the pull request summary, and required verification.

Before installing

1. Read AGENTS.md, CLAUDE.md, and any repository instructions for agent

skills or shared tools.

1. Inspect the current installed list. Prefer a repository script such as

pnpm skills:list. Otherwise run:

``bash test -f skills-lock.json && npmconfigignore_scripts=true npx --yes skills@latest list --json ``

1. Resolve the requested source and skill names. If either is unclear, list the

source before installing:

``bash npmconfigignore_scripts=true npx --yes skills@latest add <source> --list ``

Install

Run installs from the repository root. Never use --global.

Install one or more named skills from one source:

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-a> <skill-b> --agent '*' --yes

Install every skill from a source only when the user asks for all of them:

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill '*' --agent '*' --yes

GitHub lock entries contain source and skillPath. The restore command clones the source's default branch, so another run may install newer upstream content. The source must be publicly readable. Use a source with a git ref when the user requires a fixed version.

After changing the lockfile, restore every locked skill:

pnpm skills:install

This command reads skills-lock.json, writes real skill directories under .agents/skills/, and maintains matching relative links under .claude/skills/.

For Patina Project skills, use patinaproject/skills and install only the requested names. Common repository defaults are:

• scaffold-repository
• using-github
• install-skills
• grill-to-spec
• design-by-contract
• grill-system-design
• review-system-design
• writing-for-pstack

Verify

Run:

npm_config_ignore_scripts=true npx --yes skills@latest list --json
git status --short

Follow every additional check in catalog-change.md. Report the installed skills, their source, and the changed lockfile or skill directories. Stop before committing unless the user asked to finish the branch.