design-doc

Generate engineering design documents from conversation context using Google Drive templates.

1|Updated May 12, 2018
One-click install
npx skills add https://github.com/tbroadley/dotfiles --skill design-doc-tbroadley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-doc
Source: https://github.com/tbroadley/dotfiles/tree/main/claude/skills/design-doc
Command: npx skills add https://github.com/tbroadley/dotfiles --skill design-doc-tbroadley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The design-doc skill automatically generates engineering design documents from the current conversation using a standardized Google Drive template, ensuring consistency and reducing manual drafting time.

Core Features & Use Cases

  • Template-driven generation: Create documents that follow a predefined engineering design structure.
  • Context-aware content: Populate sections from conversation context, analysis, and decisions.
  • Guided workflow: Handles missing information with TODO placeholders and prompts for user input when needed.
  • Output readiness: Produces a ready-to-edit document in Google Drive or as an export.

Quick Start

  1. Start the skill during a design discussion and provide the intended document title.
  2. Let the skill locate the appropriate Google Drive template and populate sections from the conversation.
  3. Save or export the generated document to your preferred path.

Frequently Asked Questions about design-doc

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

FAQPage Schema
How do I generate an engineering design document from a conversation?

Yes, you can use Google Drive templates to standardize engineering design documents. This skill locates a predefined template in your Drive, applies structure extraction, and populates placeholders with conversation context.

How do I populate architecture decision records from an existing discussion?

To populate architecture decision records from a discussion, this skill processes conversational context and feature proposals, automatically filling template sections and inserting TODO placeholders where information is missing.

Do I need Google Drive OAuth to create template-based engineering documents?

Yes, Google Drive OAuth is required to access and use template-based engineering documents. This authentication workflow allows the skill to locate predefined templates and save the export-ready output directly to your Drive.

What happens to missing information when generating a design document?

Missing information during design document generation is handled with TODO placeholders. The guided workflow identifies gaps in feature proposals or architecture decisions and prompts for user input to complete the export-ready output.

Can I export engineering design documents to a local path instead of Google Drive?

Yes, you can export engineering design documents to a local path. The skill produces an export-ready output file after completing the template structure extraction and placeholder handling from your conversation context.