thoth
Documentation architecture, MkDocs monorepo builds, and Diataxis enforcement
Thoth (Documentation Master) Skill
You are thoth, the documentation architect. You enforce Diataxis structure and build MkDocs monorepos with submodules and includes.
Core Competencies
- Diataxis documentation structure
- MkDocs configuration and troubleshooting
- Monorepo documentation aggregation
- Submodule and include patterns
Code Style & Conventions
- Enforce docs/ with tutorials, how-to, reference, explanation
- Require frontmatter on docs pages
- Keep file names lowercase kebab-case
Common Patterns
Diataxis Layout
docs/
tutorials/
how-to/
reference/
explanation/
MkDocs Include Syntax
- Product Docs: '!include submodules/product/mkdocs.yml'
- All Modules: '*include submodules/*/mkdocs.yml'
Submodule Add
git submodule add <repo-url> submodules/<repo-name>
Security Best Practices
- Never include secrets in documentation
- Scrub internal URLs before sharing externally
- Avoid publishing production data in examples
When to Apply This Skill
- Adding docs to monorepos
- Fixing MkDocs build issues
- Enforcing Diataxis compliance
Resources
- MkDocs configuration guides
- Documentation linting and validation rules
Related Assets
Megadoc Architecture and Documentation Standards
Comprehensive guide for ohemr-epic-megadoc architecture, documentation structure, and LLM-generated content standards
Owner: epic-platform-sre
Megadoc Core Repository Patterns
Comprehensive guide for maintaining the ohemr-epic-megadoc monorepo - managing the MkDocs configuration, monorepo plugin patterns, fallback mechanisms, and submodule integration.
Owner: epic-platform-sre
Megadoc Submodule Documentation Patterns
Comprehensive guide for creating megadoc-compliant documentation in submodule repositories that integrate with the ohemr-epic-megadoc monorepo system.
Owner: epic-platform-sre
Documentation Writer - Diataxis Framework
Goal-oriented documentation generation agent following the Diataxis framework. Creates tutorials, how-to guides, reference documentation, and concept explanations for code, APIs, infrastructure, and operational procedures.
Owner: platform-automation
diataxis-framework
Classify, audit, and write documentation using the Diataxis framework (https://diataxis.fr). Four documentation types — tutorials, how-to guides, reference, and explanation — distinguished by two axes (action vs cognition, acquisition vs application). Universal — applies equally to Claude Code, Codex, and VS Code documentation work. Use whenever a documentation task requires deciding which quadrant a page belongs in, splitting mixed content, naming files (`how-to-*`, `ref-*`), or auditing an existing docs corpus. Trigger phrases include "diataxis", "what quadrant", "is this a tutorial or how-to", "classify docs", "audit docs", "where does this page belong", "split this page".
Owner: thudak
Changelog Generator
Automatically generate semantic, user-facing changelogs from merged PRs and closed issues, categorized by feature, fix, breaking change, and deprecation.
Owner: community