update-skills
Update Project Skills
Overview
Re-sync the project-scoped agent skills installed under a repo's .agents/skills/ directories with the current state of that repo. Installed skills drift as the code evolves: documented commands get renamed, paths move, flags change, conventions shift. This skill verifies each skill's factual claims against the repo and fixes what no longer holds — verify, don't rewrite. It never restyles a skill, reorders its sections, or invents new ones.
By default the skill operates recursively across the whole repository: every .agents/skills/<name>/SKILL.md at any depth is a target, including nested .agents/skills directories inside monorepo packages. Each skill is verified against its own project root — the directory holding its .agents/ dir — not the repo root blindly. Factual fixes are applied by default; pass --dry-run to preview instead.
Scope
This is the central rule for everything this skill reads and writes.
| Location | Treatment |
|---|---|
<dir>/.agents/skills/<name>/ physically inside the repo, any depth |
Target: verified and updated |
~/.agents/skills/ (global install) |
Never scanned, never written |
~/.claude/skills/ (global install) |
Never scanned, never written |
Any .claude/skills/ directory |
Never enumerated; real (non-symlink) ones silently ignored |
skills/ catalog trees (skill-development repos) |
Not an install; never a target |