What problem does it solve? Scientific and technical documentation often relies on binary images that cannot be diffed in git, edited without regeneration, or parsed by AI tools. This Skill establishes markdown with embedded Mermaid diagrams as the canonical documentation format, enforcing consistent styling, accessibility, and citation rules. ## Core Features & Use Cases - Mermaid diagram standards: Covers 24 diagram types (flowchart, sequence, ER, Gantt, radar, sankey, and more) with per-type exemplars, templates, and parser gotchas such as radar-beta syntax. - Markdown style enforcement: Rules for heading hierarchy, emoji placement, footnote citations, tables, collapsible sections, and GitHub light/dark mode compatibility. - Nine document templates: Ready-to-use templates for ADRs, issues, kanban boards, how-to guides, research papers, status reports, and more. - Use Case: When writing an architecture decision record, start from the decision_record template, add a Mermaid flowchart comparing current and future state with accTitle/accDescr accessibility annotations, and commit the .md file as the source of truth. ## Quick Start Ask the AI to write a project status report in markdown with a Mermaid Gantt chart of the timeline, following this skill's style guide and templates.
