skills.rest
PastaSus
PastaSusCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gds-agent-tech-writer

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

1|Updated Sep 18, 2026
Search Tags:#game development#documentation#markdown#mermaid#technical writing#style guide#commonmark
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill gds-agent-tech-writer-pastasus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gds-agent-tech-writer
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/gds-agent-tech-writer
Command: npx skills add https://github.com/PastaSus/egg-defender --skill gds-agent-tech-writer-pastasus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game projects accumulate scattered knowledge across code, design decisions, and architecture that teams struggle to document consistently. This Skill provides a Technical Writer persona (Paige) that authors, validates, and maintains project documentation following strict 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. - Mermaid Diagram Generation: Creates flowcharts, sequence diagrams, class diagrams, and ER diagrams in valid Mermaid v10+ syntax. - Documentation Validation: Reviews existing documents against a standards checklist and returns prioritized, actionable improvement suggestions. - Use Case: A game designer asks Paige to document the combat system architecture; the Skill interviews them for scope and audience, then produces a standards-compliant architecture doc with a Mermaid component diagram. ## Quick Start Ask Paige to write a README for your game project following documentation best practices.

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. It asks clarifying questions about scope, audience, and purpose, then drafts the document following CommonMark standards and task-oriented writing principles.

How do I create Mermaid diagrams from a text description?▼

Describe what you want to visualize and the Skill suggests an appropriate diagram type such as flowchart, sequence, class, or ER diagram. It then generates valid Mermaid v10+ syntax in a fenced code block and iterates based on your feedback.

Can I validate existing Markdown documentation against style rules?▼

Yes, the validate function reviews a specified document against the bundled documentation-standards.md checklist covering CommonMark compliance, heading hierarchy, code block language tags, and accessibility. It returns prioritized, actionable improvement suggestions.

Can I customize the documentation standards and agent persona?▼

Yes, user-specified rules can be added to the CRITICAL Rules section of documentation-standards.md, and the persona's role, style, and menu are customized via TOML override files merged at activation.

What documentation rules does this Skill enforce?▼

It enforces strict CommonMark compliance, ATX-style 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 present tense.

Related Skills

Explore More Content & Communication Skills→
anderson-0anderson-0
4

document-project

Analyze codebases to generate structured technical documentation for existing software projects.

Community
Advanced
lailtonjuniorlailtonjunior

Documentation

Generate and update Markdown and HTML documentation from code, schemas, and design notes.

Community
Intermediate
Negentropy-LabyNegentropy-Laby
3

changelog

Generate structured internal changelogs from git commits, sprint reports, and design documents.

Official
Advanced
ViperJuiceViperJuice
8

docs-sources

Detect documentation frameworks and configure fetch strategies for registry entries.

Community
Intermediate