install-skills
Installation
SKILL.md
Install And Update Skills
Use this for installing and updating Agent Skills through npx skills.
Common Contract
- Ask for scope when the user did not specify
globalorproject. - Preserve unrelated local skill files and lock mismatches. Report them instead of rewriting around them.
Install Contract
- Use the exact install commands in this workflow for default installs.
- Do not infer filesystem paths from
--agentflag names. - Do not use
--agent '*',--all, or all-agent installation unless the user explicitly names the extra agent targets. - Do not use
--copy. - Global installs use
~/.agents/skillsas the canonical store and~/.claude/skillsas the Claude Code symlink target. - Project installs create project-local agent paths under
.agents/skillsand.claude/skills; treat project.claude/skillsentries as copied directories unless the filesystem proves they are symlinks. - If a source exposes multiple skills and the user did not name the exact skill or skills, list the available skills with their purpose and ask the user to choose.