gds-agent-tech-writer

Generates and validates CommonMark-compliant technical documentation and Mermaid diagrams for game projects.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill gds-agent-tech-writer-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-agent-tech-writer
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/gds-agent-tech-writer
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill gds-agent-tech-writer-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game development teams struggle to keep documentation consistent, accurate, and accessible across designers, engineers, and AI agents. This Skill provides a dedicated Technical Writer persona (Paige) that authors, validates, and maintains project documentation following strict CommonMark and style standards. ## Core Features & Use Cases - Document Authoring: Guides multi-turn conversations to write READMEs, API references, user guides, and architecture docs following documentation-standards.md best practices. - Mermaid Diagram Generation: Creates flowcharts, sequence diagrams, class diagrams, and ER diagrams with valid Mermaid v10+ syntax. - Documentation Validation: Reviews existing documents against CommonMark rules, style guides, and accessibility standards, returning prioritized improvement suggestions. - Use Case: A game studio needs architecture documentation for a new rendering system. Invoke Paige, select the Write Document menu item, and receive a structured doc with Mermaid diagrams that passes CommonMark validation. ## Quick Start Ask Paige to write architecture documentation for your game project with a Mermaid system overview diagram.

Frequently Asked Questions about gds-agent-tech-writer

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

FAQPage Schema
How do I write technical documentation for a game project?

Invoke the Technical Writer agent and select the Write Document menu option. It asks clarifying questions about scope, audience, and purpose, then drafts a document following CommonMark standards with task-oriented structure and diagrams where helpful.

How to create Mermaid diagrams from a text description?

Use the Mermaid Generate menu item and describe what you want to visualize. The agent suggests a diagram type such as flowchart, sequence, class, or ER diagram, then produces valid Mermaid v10+ syntax in a fenced code block.

Can I validate existing Markdown docs against style standards?

Yes, the Validate Documentation menu item reviews any specified document against documentation-standards.md, checking CommonMark compliance, heading hierarchy, code block language tags, link quality, and accessibility, then returns prioritized fixes.

Can I customize the documentation rules the agent enforces?

Yes, the Update Standards menu item adds your preferences to the User Specified CRITICAL Rules section of documentation-standards.md. These custom rules supersede the general rules and are applied to all future writing and validation.

What documentation formats and standards does it support?

It supports CommonMark Markdown, Mermaid diagrams, OpenAPI 3.0+ API documentation, and YAML frontmatter. Style guidance follows project-specific guides first, then BMAD conventions, then Google Developer Docs style defaults.