| name | home-docs-curator |
| description | README、AGENTS、CLAUDE、ツール別READMEを俯瞰し、重複・古い前提・読みにくい構成・不要ファイルを整理する。ドキュメント整備やリポジトリを読みやすくしたいときに使用。 |
home-docs-curator
Use this skill for documentation cleanup across a repository.
Workflow
-
Read root entry points first:
README.md
AGENTS.md
CLAUDE.md
- tool-specific README files
-
Build a map:
- setup and apply commands
- source-of-truth files
- generated or linked targets
- archive/reference-only paths
-
Remove or merge docs only when they are redundant:
- duplicate instructions with no additional context
- stale references to removed tooling
- generated state or local-only notes
-
Keep docs task-oriented:
- where to edit
- how to apply
- how to validate
- what not to track
-
Validate claims against the repo:
rg -n "stale term|removed tool|old path"
./scripts/link.sh
Don't
- Do not preserve historical explanations in active docs just because they are interesting.
- Do not move local secrets, sessions, caches, or logs into documentation.
- Do not create a second source of truth when a table can point to the existing file.