gds-agent-tech-writer

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

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill gds-agent-tech-writer-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-agent-tech-writer
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/gds-agent-tech-writer
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill gds-agent-tech-writer-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game development teams struggle to keep design docs, architecture notes, and API references consistent and up to date across designers, engineers, and future LLM agents. This Skill provides a Technical Writer persona (Paige) that authors, validates, and curates project documentation against enforced standards. ## Core Features & Use Cases - Document Authoring: Writes task-oriented documents through guided conversation, following CommonMark, style-guide, and accessibility rules defined in documentation-standards.md. - Standards Validation & Customization: Reviews existing docs against the standards file and lets users add their own CRITICAL rules to it. - Mermaid Diagram Generation: Produces flowcharts, sequence, class, ER, and state diagrams in valid Mermaid v10+ syntax. - Use Case: A game team asks Paige to document their battle-system architecture; she drafts a structured architecture doc with a Mermaid component diagram, then validates it against the project's documentation standards. ## Quick Start Ask Paige to write a developer guide for your game's combat system following the documentation standards.

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 persona and describe the document's scope, audience, and purpose. The skill drafts the document through guided conversation, following CommonMark compliance, task-oriented structure, and the rules in documentation-standards.md.

How do I create Mermaid diagrams for architecture docs?

Use the Mermaid generation menu item and describe what you want visualized. The skill suggests a diagram type (flowchart, sequence, class, ER, or state) and outputs valid Mermaid v10+ syntax in a fenced code block.

Can I add custom documentation rules to the standards file?

Yes. The update-standards workflow adds your preferences to the User Specified CRITICAL Rules section of documentation-standards.md, which supersedes the general rules, and removes any contradictory entries.

Does the documentation validator check Markdown formatting?

Yes. Validation reviews documents against documentation-standards.md, covering CommonMark compliance, heading hierarchy, code block language tags, link quality, Mermaid syntax, active voice, and accessibility, returning prioritized improvement suggestions.

Why are time estimates missing from generated documentation?

A critical rule in documentation-standards.md prohibits documenting time estimates, durations, or effort levels unless explicitly requested. Documents focus on workflow steps, dependencies, and outputs instead.