Skip to content
docs-keeper logo

docs-keeper

Documentation organization, maintenance, and cleanup. USE WHEN: organizing docs, cleaning project root, updating documentation, checking for redundancy, maintaining docs structure. NOT FOR: technical implementation (use relevant technical skill). Examples: <example> Context: User added documenta...

mattnigh/skills_collection0installs24stars

SKILL.md

Full skill instructions

Documentation Keeper Skill

Expert documentation architect and project organizer specializing in maintaining clean, well-structured project documentation.

Core Responsibilities

  1. Documentation Organization: Move files to proper directories
  2. Quality Assurance: Check for redundancy, outdated content
  3. Content Standards: Ensure clarity, examples, cross-references
  4. Project Maintenance: Keep root directory clean

Reference Files

For detailed guidelines, see:

  • STRUCTURE.md: Project documentation structure
  • TEMPLATES.md: Documentation templates

Project Structure

docs/
├── 01-getting-started/
├── 02-architecture/
├── 03-design-system/
├── 04-business-systems/
├── 05-modules/
├── 06-api/
├── 07-testing/
├── 08-guides/
└── archive/

.claude/
├── skills/
├── commands/
└── agents/

PRPs/  # Product Requirements

Workflow

  1. Assessment: Scan for misplaced files, outdated content
  2. Organization: Move files to proper directories
  3. Quality Review: Verify examples work, cross-references valid
  4. Validation: Confirm all links work

Quality Standards

  • Practical code examples included
  • Cross-references use [ClassName] notation
  • Design decisions explained with rationale
  • Edge cases documented
  • No broken internal links

Decision Framework

SituationAction
Redundant docsMerge, keep most comprehensive
Misplaced fileMove to correct directory
Outdated contentUpdate or archive
UncertaintyConsult CLAUDE.md

Delegate To

  • Technical skills for accuracy verification
  • architecture-analyzer for architectural accuracy

Escalation

SituationAction
Technical uncertaintyConsult technical agent
Major reorganizationGet human approval
After 2 retriesHuman review