curate-docs
Use when a repo's markdown docs have drifted — orphaned or unreferenced docs, plans nobody triaged, an archive nobody drained, a docs/ directory nobody can navigate, stale architecture or spec docs, broken links between docs, "which doc is current", "why does this doc exist", or before answering an architecture or methodology question from docs you have not verified are current.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- curate-docs
- description
- Use when a repo's markdown docs have drifted — orphaned or unreferenced docs, plans nobody triaged, an archive nobody drained, a docs/ directory nobody can navigate, stale architecture or spec docs, broken links between docs, "which doc is current", "why does this doc exist", or before answering an architecture or methodology question from docs you have not verified are current.
02 资源文件 49
- 参考文档.claude-plugin/marketplace.json692 B
- 参考文档.claude-plugin/plugin.json738 B
- 其他.gitignore30 B
- 参考文档.propagates.yml5.5 KB
- 脚本cli.mjs16.6 KB
- 脚本lib/branches.mjs3.8 KB
- 脚本lib/config.mjs6.1 KB
- 脚本lib/discovery.mjs6.6 KB
- 脚本lib/evidence.mjs6.9 KB
- 脚本lib/impact.mjs4.7 KB
- 脚本lib/link-graph.mjs15.0 KB
- 脚本lib/reference-integrity.mjs9.2 KB
- 脚本lib/report.mjs13.1 KB
- 脚本lib/state.mjs8.2 KB
- 脚本lib/taxonomy.mjs9.2 KB
- 许可证LICENSE1.0 KB
- 参考文档package-lock.json698 B
- 参考文档package.json289 B
- 参考文档README.md1.3 KB
- 参考文档sections/design.md4.5 KB
- 参考文档sections/eng.md4.7 KB
- 脚本tests/_tmp.mjs1.2 KB
- 脚本tests/branches.test.mjs3.8 KB
- 脚本tests/cascade.test.mjs5.7 KB
- 脚本tests/config.test.mjs4.1 KB
- 脚本tests/discovery.test.mjs5.9 KB
- 脚本tests/drain.test.mjs6.5 KB
- 参考文档tests/fixtures/PLAYBOOK.md45 B
- 参考文档tests/fixtures/sample-repo/CLAUDE.md99 B
- 参考文档tests/fixtures/sample-repo/docs/ARCHITECTURE.md141 B
- 参考文档tests/fixtures/sample-repo/docs/cluster/a.md137 B
- 参考文档tests/fixtures/sample-repo/docs/cluster/b.md53 B
- 参考文档tests/fixtures/sample-repo/docs/DECISIONS.md55 B
- 参考文档tests/fixtures/sample-repo/docs/design/DESIGN.md147 B
- 参考文档tests/fixtures/sample-repo/docs/plans/2026-01-01-active.md156 B
- 参考文档tests/fixtures/sample-repo/docs/plans/2026-01-02-orphan.md76 B
- 参考文档tests/fixtures/sample-repo/docs/plans/2026-01-03-sibling.md138 B
- 参考文档tests/fixtures/sample-repo/docs/README.md150 B
- 参考文档tests/fixtures/sample-repo/docs/specs/api.md237 B
- 参考文档tests/fixtures/sample-repo/README.md68 B
- 参考文档tests/fixtures/sample-repo/STATE.md272 B
- 脚本tests/link-graph.test.mjs9.9 KB
- 脚本tests/reference-integrity.test.mjs9.1 KB
- 脚本tests/report.test.mjs4.1 KB
- 脚本tests/repos.test.mjs6.6 KB
- 脚本tests/state.test.mjs6.9 KB
- 脚本tests/taxonomy.test.mjs7.1 KB
- 脚本tests/tmp-fixtures.test.mjs4.2 KB
- 其他VERSION6 B
03 SKILL.md 正文
curate-docs
<!-- premise:start --> Every document should have a calling node — something that cites it, reachable from an entry point. A document nothing calls is not necessarily wrong; it is undecided, and the decision is what this drives to.
The decision is recorded in the document, and only then is the document moved or removed. <!-- premise:end -->
The pipeline
1 DERIVE ──▶ 2 DECLARE ──▶ 3 SALVAGE ──▶ 4 DRAIN ──▶ 5 RECONCILE
report state --set merge live drain report again
impact --apply facts fwd --apply
node "${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/propagate}/skills/curate-docs/cli.mjs" <mode> <dir> [--extra-root <workspace>]
Pass --extra-root <workspace> for any sub-repo, or correct cross-repo citations like
../STATE.md get misreported.
Which section to read
These are sections of this skill, not separate skills — Read the file when its
situation applies. They were nested at skills/{design,eng}/SKILL.md, a shape Claude Code
discovers nowhere, so as skills they reached a session only via hand-made symlinks that
declared the bare names design and eng.
| You are doing | Read |
|---|---|
| Deciding what should happen to a doc — triaging an orphan, judging whether a plan landed, salvaging facts, checking what breaks if it goes | sections/design.md |
| Driving the tool — which mode, which flag, why a count or a refusal looks wrong | sections/eng.md |
Steps 1 and 5 are mostly sections/eng.md; steps 2–4 need sections/design.md to decide
and sections/eng.md to execute.
Contract
Two rules both subskills obey, stated once here:
Declaring is the archival act. Do not git mv into docs/archive/. Moving rewrites
every relative path the doc owns — proven, one move produced two orphans and a dangling
citation. Once the state is in the file, the move buys nothing.
Never regenerate an index to clear the orphan list. It manufactures a link so the count goes green while nobody decided anything — the exact failure this skill exists to prevent.
Reference
docs/GOTCHAS.md — 19 instrument failures paid for during the two build phases. Read it
before trusting a surprising number. docs/DECISIONS.md — why the pipeline has these five
steps and not others.
04 同仓库更多 Skills
propagate
暂无简介
design-workflow
Use when building or changing UI, components, design tokens, colours, typography, motion, imagery or a DESIGN.md, in any frontend stack (Flutter, Next.js, React, Obsidian, UI5), and before approving a plan that touches a rendered surface. Gives the ten-step design workflow, the definition of done for a component, and the per-stack way to do each step.
propagate
Use when a change to one file needs to reach files that must move with it — across branches, worktrees, or repos. Triggers on "/propagate", "propagation status", "drain propagation", "what depends on this", "did anything drift", "what did I forget to update", a red or unexplained propagate check, or any reference to PROPAGATION_LEDGER or a .propagates.yml sidecar.