Documentation Standards

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

Overview

Standards for writing markdown documentation optimized for both LLM consumption and conversion to professional PDFs using Pandoc. Ensures consistency across all documentation.

When to Use This Skill

Use when:

• Writing markdown documentation (README, skills, guides, specifications)
• Creating new skills that include markdown content
• Authoring content that may be converted to PDF
• Reviewing documentation for standards compliance

Core Principles