ccfg-markdown

Generate or update a living documentation index for the repository

Initialize documentation structure and templates (README, ADR, API docs, changelog, contributing)

Run Markdown quality gate suite (lint, link validation, frontmatter, structure, code fence integrity, doc freshness)

Use this agent for documentation structure design, README patterns, ADR (Architecture Decision Record) templates, API documentation structure, changelog formatting, contributing guides, and information architecture. Invoke for creating or restructuring documentation, designing doc hierarchies, writing READMEs following standard patterns, setting up ADR workflows with MADR format, organizing API docs with endpoint/method/params/response/errors patterns, maintaining changelogs in Keep a Changelog format, and establishing file organization conventions. Examples: creating a README for a new project, setting up an ADR directory with templates, structuring API documentation for a REST service, initializing a changelog, writing a CONTRIBUTING guide, or reorganizing scattered docs into a coherent hierarchy.

Use this agent for Markdown syntax, GitHub Flavored Markdown (GFM) features, frontmatter validation, linting rules, formatting corrections, link validation, and markdown best practices. Invoke for writing well-structured markdown, fixing formatting issues, validating internal links and anchors, checking code fence integrity, frontmatter YAML syntax, table alignment, list indentation, heading hierarchy enforcement, and line length compliance. Examples: fixing broken heading hierarchy, adding language tags to code fences, validating internal link targets, correcting table alignment, enforcing consistent emphasis style, or auditing frontmatter fields across multiple markdown files.

This skill should be used when creating or structuring documentation, writing READMEs, designing documentation architecture, or organizing project documentation.

This skill should be used when working with Markdown, writing documentation, formatting markdown files, or reviewing markdown content.

This skill should be used when improving documentation clarity, reviewing technical writing quality, or ensuring documentation is complete and readable.