drafting-design-doc

Draft and audit Design Docs against a defined checklist.

Updated Aug 18, 2025
One-click install
npx skills add https://github.com/masa-codehub/gemini_agent --skill drafting-design-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drafting-design-doc
Source: https://github.com/masa-codehub/gemini_agent/tree/main/.gemini/skills/drafting-design-doc
Command: npx skills add https://github.com/masa-codehub/gemini_agent --skill drafting-design-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Draft and audit comprehensive Design Docs to capture context, design decisions, models, and a rigorous self-audit trail against defined checklists.

Core Features & Use Cases

  • Self-guided Design Doc drafting based on a Design Brief.
  • Integrated self-audit using the assets/design-doc-audit-checklist.md to validate completeness.
  • Generates a reusable Design Doc artifact (templates + audit evidence) for peer review and archival.

Quick Start

Initiate the drafting workflow and progress through Goal Setting, Preparation, Content Drafting, and Self-Audit to produce a completed Design Doc.

Frequently Asked Questions about drafting-design-doc

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

FAQPage Schema
How do I draft a design doc and ensure it captures context and decisions?

Drafting a design doc requires capturing context, decisions, and auditing evidence. This Skill guides you through goal setting, preparation, content drafting, and a self-audit to produce a comprehensive design document.

What is a self-audit checklist for design documentation?

A self-audit checklist for design documentation validates completeness against defined criteria. It ensures your design doc explicitly satisfies requirements for goals, preparation templates, content drafting, and audit evidence.

How do I structure a design brief for a new project?

Structuring a design brief involves defining explicit goals to guide your design work. The workflow progresses through goal setting and preparation templates to generate a reusable design doc artifact for peer review.

Can I use a design doc template for peer review and archival?

Yes, you can use a design doc template for peer review and archival. The workflow generates a reusable artifact containing templates and self-audit evidence, ensuring the document is complete and ready for evaluation.

Does design documentation work without a formal auditing step?

Design documentation without a formal auditing step lacks a rigorous self-audit trail. Applying a checklist validates completeness by checking for explicit goals, preparation, content drafting, and audit evidence.

What is the best way to audit a design doc end-to-end?

The best way to audit a design doc end-to-end is applying a self-audit checklist after content drafting. This validates that the document captures context, design models, and decisions with rigorous evidence.