Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Han Documentation Update Sweep

A repo-maintenance skill that audits and fixes every skill, agent, index, and cross-reference doc in the Han plugin repository.

Dev & CodingAdvanced★ 219⑂ 21AI score 6/10Last updated: Aug 19, 2026

What it does

  • Detects mode automatically: on a non-default branch it scopes the audit to entities the branch touched (branch mode); on the default branch it sweeps the whole plugin suite (sweep mode).
  • Discovers skill roots (han-*/skills) and agent roots from disk instead of hardcoding a plugin list, then builds an ordered inventory: skills → agents → indexes → concept docs → guidance → templates → root files.
  • Reads the source of truth (SKILL.md, agent file) before the long-form doc, treating doc-vs-source contradictions as functional bugs.
  • Cross-checks bidirectional skill boundaries, index and CLAUDE.md catalog completeness, count-free references (no reintroduced "21 skills"), and stale names in docs/workflows.md chains and mermaid diagrams.
  • Applies fixes with Edit (Write only for creating a missing long-form doc from a template), leaves <!-- TODO: human review --> markers for judgment calls, and stops at a report — no commit, push, or PR.

Who it's for

  • Contributors maintaining the testdouble/han plugin repository
  • Teams keeping a large multi-package documentation set internally consistent
  • Skill authors who want a reference audit workflow to adapt to their own repo

Examples

  1. On a branch that adds a new skill, ask "update the docs" — it scopes the new skill plus the indexes and CLAUDE.md catalog and scaffolds the missing long-form doc.
  2. On the default branch, run "doc sweep" — it audits every skill, agent, index, and concept doc, batching five entities per content-auditor agent with at most four in parallel.
  3. After renaming a skill, the cross-reference pass flags leftover old names in docs/workflows.md composition chains and diagrams.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/testdouble/han/HEAD/.claude/skills/han-update-documentation/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/han-update-documentation folder from the GitHub repo testdouble/han into my ~/.claude/skills/han-update-documentation/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/testdouble/han.git && cp -r han/.claude/skills/han-update-documentation ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repository: git clone https://github.com/testdouble/han.git
  3. Copy the skill into your personal skills folder: cp -r han/.claude/skills/han-update-documentation ~/.claude/skills/
  4. Verify that scripts/detect-doc-update-context.sh and the references/ folder came along — without them the skill halts at Step 1.
  5. Because it only works inside the Han repo, cd han and start Claude Code there.
  6. Trigger it with a request like "update the docs", "doc sweep", or "audit the docs".
  7. Review the reported file list with git diff and commit yourself — the skill never commits.
View source on GitHub ↗License: MIT