skills.rest
jgabriellima
jgabriellimaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gds-agent-tech-writer

Generates and validates game project documentation following CommonMark and Mermaid standards.

Updated May 7, 2026
Search Tags:#game development#documentation#markdown#mermaid#technical writing#style guide#commonmark
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill gds-agent-tech-writer-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gds-agent-tech-writer
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/gds-agent-tech-writer
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill gds-agent-tech-writer-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game projects accumulate scattered knowledge across design docs, architecture notes, and API references that quickly drift out of sync. This Skill activates Paige, a Technical Writer persona that authors, validates, and maintains project documentation against enforced CommonMark and style standards. ## Core Features & Use Cases - Document Authoring: Writes READMEs, API references, user guides, and architecture docs through guided conversation, following CommonMark and Google Developer Docs style rules. - Standards Validation: Reviews existing documents against documentation-standards.md and returns prioritized, actionable improvement suggestions. - Mermaid Diagram Generation: Creates flowcharts, sequence diagrams, class diagrams, and ER diagrams in valid Mermaid v10+ syntax. - Use Case: Ask Paige to document your game's save-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 the Technical Writer to write an architecture document for your game's inventory system with a Mermaid 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 persona and describe the document you need, such as an architecture doc or user guide. The skill asks clarifying questions about scope and audience, then drafts the document following CommonMark and task-oriented writing standards.

How to validate Markdown documentation against style rules?▼

Use the validate documentation menu option (VD) and point to your document. The skill reviews it against documentation-standards.md covering CommonMark compliance, heading hierarchy, code block language tags, and accessibility, then returns prioritized improvement suggestions.

Can I generate Mermaid diagrams from a text description?▼

Yes, the Mermaid generation workflow (MG) takes a natural language description and produces valid Mermaid v10+ syntax. It supports flowcharts, sequence diagrams, class diagrams, ER diagrams, and state diagrams, iterating based on your feedback.

Can I customize the Technical Writer persona and menu?▼

Yes, customize.toml defines the persona's role, communication style, principles, and menu items. Team and user-level TOML overrides merge structurally, letting you adjust behavior without changing the core Paige identity.

What documentation standards does this skill enforce?▼

It enforces strict CommonMark compliance, ATX headers, fenced code blocks with language tags, descriptive link text, and a prohibition on time estimates. Style defaults follow Google Developer Docs guidance with active voice and task-oriented structure.

Related Skills

Explore More Content & Communication Skills→
dangernoodle-iodangernoodle-io

persist

Persist decisions, facts, notes, and plans from conversations into the Ouroboros knowledge base.

Official
Advanced
chujianyunchujianyun
715

qoder-wiki

Automate structured project documentation generation from code and existing docs.

Community
Intermediate
bmad-code-orgbmad-code-org
52.5k

bmad-document-project

Forwards deprecated project documentation requests to the bmad-project-context skill.

Official
Basic
John2143John2143
2

humanizer

Rewrite AI-generated text in literary author styles with dynamic persona selection.

Community
Advanced