| name | Docs: Update Target |
| description | {{ ƔƔƔ }} Update an existing documentation file to reflect recent code changes |
| when_to_use | When a doc (other than README or an ADR) has drifted from the code and needs its content reconciled with what actually shipped since it was last touched. |
| model | sonnet |
| disable-model-invocation | true |
| allowed-tools | ["Read","Glob","Grep","Edit","Bash(git:*)","Bash(~/.claude/library/scripts/git-doc-history.sh:*)"] |
| argument-hint | ["doc path or name","e.g. Technical-Overview"] |
Analyse recent code changes and update the specified documentation file. (For READMEs specifically, use doc-readme — this skill covers everything else: technical overviews, ADRs, guides.)
Steps
-
Resolve the doc from $ARGUMENTS (a path, or a name to Glob for under docs/). If nothing was given or nothing matches, ask — do not guess which doc was meant.
-
Read the doc to understand its structure and style, then gather what changed in one command:
"$HOME"/.claude/library/scripts/git-doc-history.sh {doc-path} {scope-dir}
Pass the code directory the doc describes as the scope (default: the doc's own directory, which is rarely right for docs living under docs/ — pick the source dir it documents).
-
Identify specific updates needed: outdated sections, missing coverage of new behaviour, stale examples.
-
Generate updates preserving the existing structure; show a diff; apply on approval.
-
Update any timestamp in the doc's frontmatter.
Notes
- Match the existing documentation style; British spelling.
- Don't remove content unless it is genuinely obsolete.
- If nothing needs updating, say so plainly.