update-skills

Installation
SKILL.md

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
Installs
12
GitHub Stars
63
First Seen
13 days ago
update-skills — paulrberg/agent-skills