Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →testdouble/han-update-documentation
Update Han plugin documentation so every skill, agent, guidance doc, index, and cross-reference is current and accurate. On a non-default branch, scopes the pass to entities the branch actually touched. On the default branch, performs a full documentation sweep across the whole plugin.
Passed 8 of 13 test cases with the skill, and 4 of 13 without it.
and 11 more in the full report
9 fixed4 passed either way7 still failing2 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.
A feature branch modified a skill, an agent, `README.md`, `docs/concepts.md`, and `docs/skills/README.md`. In what order should these entities be structured in the inventory list before auditing?
| Checked | Without skill | With skill |
|---|---|---|
| Places skills first, followed by agents, then indexes, top-level concept docs, and finally root files in the audit inventory. | Missed | Passed |
| Names `docs/skills/README.md` in the index section of the inventory ahead of top-level concept docs. | Missed | Passed |
The instructions your model reads when the skill loads.
which git 2>/dev/null || echo "not installed"find . -maxdepth 3 -name "plugin.json" -path "*/.claude-plugin/*" -type ffind . -maxdepth 2 -type d -name skills -path './han-*/skills' ! -path './han-plugin-builder/skills' 2>/dev/null | sed 's|^\./||' | sortfind . -maxdepth 2 -type d -name agents -path './han-*/agents' 2>/dev/null | sed 's|^\./||' | sortIf any of the above are empty or read not installed: this skill is intended to run inside the Han plugin
repository. Tell the operator which marker is missing and stop. Do not attempt to operate on a different repo.
git branch --show-current 2>/dev/null || echo unknowngit symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null || echo unknownRun ${CLAUDE_SKILL_DIR}/scripts/detect-doc-update-context.sh and read its output. Branch on the mode: line.
The script also emits the skill roots (between skill-roots-start and skill-roots-end) and the agent root
(the agent-root: line), both discovered dynamically from disk. These are the authoritative roots for the rest of this
skill — use them wherever the steps below say "the skill roots" or "the agent root," rather than any hardcoded plugin
list. A skill root is every han-*/skills directory except han-plugin-builder/skills, whose guidance skill is
authoring guidance audited under guidance docs (Step 2, sweep), not a documented product skill. Adding a new product
plugin needs no edit to this skill; it shows up in the discovered roots automatically.
mode: error — stop. Surface the reason: line to the operator. Do not proceed.
mode: branch — branch scope. Set MODE = branch. Read the file list between changed-files-start and
changed-files-end (or note that the file list is empty if changed-files: none appears instead). If the file list is
empty, inform the operator that the branch has no changes against the default branch and stop.
mode: sweep — full sweep. Set MODE = sweep. The skill audits every documentation entity across the plugin suite
(every skill root the detect script reported, plus the agent root).
Echo back the mode and the count of in-scope files (branch mode) or "full plugin sweep" (sweep mode) so the operator knows what is about to happen.
test cases passed, vs 4 / 13 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.