google-design-md

Generate/edit DESIGN.md filesGitHub with sections for SDLC.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/allanninal/claude-code-skills --skill google-design-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-design-md
Source: https://github.com/allanninal/claude-code-skills/tree/main/skills/google-design-md
Command: npx skills add https://github.com/allanninal/claude-code-skills --skill google-design-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create and maintain comprehensive DESIGN.md files for your software projects, ensuring clear documentation of architecture, design decisions, and technical specifications according to Google Labs conventions.

Core Features & Use Cases

  • Architecture Documentation: Visually represent system architecture with diagrams and component descriptions.
  • Design Decision Recording: Document the rationale behind key technical choices using a structured format.
  • Use Case: When starting a new feature or system, use this Skill to generate a DESIGN.md file that outlines the proposed architecture, data models, API design, and critical decisions, facilitating team alignment and reviews.

Quick Start

Generate a DESIGN.md file for a new microservice called 'user-auth'.

Frequently Asked Questions about google-design-md

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

FAQPage Schema
How do I generate a DESIGN.md file following Google Labs conventions?

To generate a Google-style DESIGN.md file, use a template that structures system architecture, data models, API design, and key technical decisions. This ensures clear documentation of technical specifications for project onboarding and team alignment.

What sections should be included in a technical specification for system architecture?

A technical specification for system architecture should include standard sections like Overview, Architecture, Data Model, API Design, Key Decisions, Security, Performance, Testing, Deployment, and Future Considerations to document design decisions comprehensively.

How do I document design decisions and system architecture for a new software project?

You document design decisions and system architecture by generating a DESIGN.md file that visually represents components and records the rationale behind technical choices using a structured format for team reviews.

Can I use Google-style DESIGN.md templates for microservice architecture documentation?

Yes, you can use Google-style DESIGN.md templates for microservice architecture documentation. They support outlining proposed architecture, data models, and critical decisions for new services like user authentication systems.

What is the best way to structure a technical specification for onboarding new team members?

The best way to structure a technical specification for onboarding is using a DESIGN.md file that outlines system architecture, API design, and security considerations, facilitating quick team alignment and technical reviews.

Does a standard DESIGN.md file cover API design and data model documentation?

Yes, a standard DESIGN.md file covers API design and data model documentation. It includes dedicated sections for both, ensuring comprehensive technical specifications and clear architectural records.