skills/doc-misc-update/SKILL.md
{{ ƔƔƔ }} Update an existing documentation file to reflect recent code changes
npx skillsauth add jasonwarrenuk/goblin-mode Docs: Update TargetInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.)
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.
tools
{{ 𝚫𝚫𝚫 }} Rebuild roadmap-system.zip, the distributable snapshot of the roadmap tooling (scripts, HTML template, conventions reference, and every roadmap-touching skill, including this one).
tools
--- name: "Suggest: Task" description: "{{ 𝚫𝚫𝚫 }} Suggest the next logical task — grounded in the roadmap's pre-vetted ready-set when one exists, codebase analysis otherwise" when_to_use: "When you don't know what to work on next and want a grounded recommendation rather than picking arbitrarily." model: haiku effort: low disable-model-invocation: true allowed-tools: ["Read", "Glob", "Grep", "Bash(python3:*)", "Bash(npm:*)", "Bash(bun:*)", "Bash(pnpm:*)", "Bash(deno:*)"] argument-hint: [named
development
{{ 𝛀𝛀𝛀 }} Convert an old simple-style roadmap (single Markdown, four statuses, <a name> anchors, roadmaps.json pointer registry) into the rich phase-array format (roadmaps.json source of truth + PHASE task list + prose overview).
data-ai
{{ ƔƔƔ }} Create a pull request to main — wordy or shiny (with screenshots), ready-for-review or draft