Agent skill
docs-structure-maintainer
Understand and maintain HuleEdu documentation and task documentation structure. Guides placement, naming, and validation using the canonical specs and management scripts.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/documents/docs-structure-maintainer
SKILL.md
Documentation Structure Maintainer
Compact skill for reasoning about HuleEdu documentation layout and TASKS structure, and for invoking the right scripts to keep them compliant.
When to Use
Activate when the user:
- Creates, moves, or renames documentation under
documentation/orTASKS/ - Asks where a doc should live (operations vs decisions vs how-to vs tasks)
- Wants to validate or migrate documentation structure
- Mentions
validate_docs_structure.py,migrate_docs_structure.py,task_mgmt, or doc/TASKS specs
Core Capabilities
- Classify content type and map it to the correct directory:
documentation/overview|architecture|services|operations|how-to|reference|decisions|product|researchTASKS/domain taxonomy:programs/,assessment/,content/,identity/,frontend/,infrastructure/,security/,integrations/,architecture/,archive/
- Suggest compliant filenames and directory names (kebab-case, no spaces; id-based filenames in
TASKS/) - Ensure required frontmatter for:
- Runbooks and ADRs (per
documentation/DOCS_STRUCTURE_SPEC.md) - Task and programme docs (per canonical TASKS spec)
- Runbooks and ADRs (per
- Propose concrete commands for:
python scripts/docs_mgmt/validate_docs_structure.py [--strict]python scripts/docs_mgmt/migrate_docs_structure.py ...python scripts/task_mgmt/new_task.py ...python scripts/task_mgmt/validate_front_matter.py ...python scripts/task_mgmt/index_tasks.py ...
Quick Workflow
- Identify doc intent (architecture, runbook, ADR, how-to, product, task, programme).
- Map to the correct directory using
DOCS_STRUCTURE_SPEC.mdand the TASKS structure spec. - Choose or normalize filename and directory name to match naming rules.
- Ensure or suggest correct frontmatter for the doc type.
- Recommend validation/migration commands using
scripts/docs_mgmtandscripts/task_mgmt.
Reference Documentation
- Detailed Workflows & Patterns: See
reference.mdin this directory - Real-World Usage Examples: See
examples.mdin this directory - Normative Rules:
.claude/rules/090-documentation-standards.md
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?