documentation

Standardize changelogs, feature specs, and module documentation with templates and validation scripts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/AlexanderStephenThompson/claude-hub --skill documentation-alexanderstephenthompson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/AlexanderStephenThompson/claude-hub/tree/main/core/skills/documentation
Command: npx skills add https://github.com/AlexanderStephenThompson/claude-hub --skill documentation-alexanderstephenthompson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies and enforces documentation standards across changelogs, feature specs, and module documentation, ensuring a single source of truth and consistent structure.

Core Features & Use Cases

  • Documentation ships with code — Ensures documentation accompanies features and enables agent context with up-to-date references.
  • Single source of truth — The /Documentation structure aggregates roadmap, architecture, and module specs for consistent guidance.
  • Living documents — Templates and guidelines help teams keep changelogs, feature specs, and module docs current.

Quick Start

To begin, review the /Documentation folder structure, then generate or update the following files:

  • Create or edit Documentation/project-roadmap.md, Documentation/architecture.md, and Documentation/changelog.md following the templates in assets/ or references/.
  • Use scripts/validate_docs.py to validate structure and fix issues.

Frequently Asked Questions about documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize project documentation structure for changelogs and feature specs?

To standardize project documentation, use predefined templates and a dedicated folder structure to enforce consistency across changelogs, feature specs, and module docs. This ensures a single source of truth and keeps living documents current.

What is the best way to keep module documentation accurate and aligned with code changes?

Keeping module documentation accurate requires enforcing frontmatter usage and integrating validation scripts. This approach checks structure and alignment, ensuring docs ship with code and remain a reliable, up-to-date reference.

How do I validate documentation structure and fix formatting issues automatically?

You validate documentation structure by running a validation script like validate_docs.py against your project files. This script checks the /Documentation folder structure, verifies frontmatter usage, and helps fix formatting issues.

Does this documentation approach require a specific folder structure for project roadmaps and architecture specs?

Yes, the documentation approach requires a specific /Documentation folder structure. You aggregate roadmap, architecture, and module specs within this directory, using ready-to-use templates to maintain consistent structure across project artifacts.

Why use frontmatter in changelogs and feature spec templates?

Using frontmatter in changelogs and feature spec templates enforces standardization and creates a single source of truth. It provides consistent metadata for validation scripts to verify, keeping living documents structured and actionable.

Can I use these documentation guidelines for an existing project with unstructured docs?

Yes, you can apply these documentation guidelines to existing projects by creating or editing files like project-roadmap.md, architecture.md, and changelog.md. Use the provided templates to restructure existing documentation into a standardized format.