plumbeer-design-creator

Interactively author design docs section by section with checklist-gated review.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/marioplumbeer/skills --skill plumbeer-design-creator-marioplumbeer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plumbeer-design-creator
Source: https://github.com/marioplumbeer/skills/tree/main/.agents/skills/plumbeer-design-creator
Command: npx skills add https://github.com/marioplumbeer/skills --skill plumbeer-design-creator-marioplumbeer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a design doc that survives review is hard: authors skip sections, propose a single solution without alternatives, or advance before goals are validated. This Skill walks you through authoring a design doc one section at a time, gating each phase against the plumbeer-design-reviewer checklist so the finished document is review-ready by construction. ## Core Features & Use Cases - Section-by-section authoring: Builds the doc from a bundled markdown template covering Problem, Challenges, Goals, Strategy, Cost, API, Risks, Schedule, and more. - Checklist-driven gating: Invokes the plumbeer-design-reviewer skill after each section and loops on Partial or Not Met rows until they pass, with explicit user confirmation required for process gates like ally reviews. - Explicit bypass tracking: Skipped gates are recorded visibly in the doc rather than silently omitted, and existing files can be resumed from the first unmet checklist row. - Use Case: You need a high-level design for a new service. The Skill interviews you for the problem and goals, pushes back when you offer only one candidate solution, verifies ally reviews happened, and produces a single markdown file that passes the full 24-row readiness matrix. ## Quick Start Ask the assistant to help you write a design doc for your project from scratch, and it will interview you section by section while gating progress on the design review checklist.

Frequently Asked Questions about plumbeer-design-creator

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

FAQPage Schema
How do I write a design doc that passes design review?▼

Author it section by section against the review checklist rather than writing it all at once. This Skill interviews you for each section, runs the plumbeer-design-reviewer checklist after each one, and loops on weak sections until every relevant row is Met before advancing.

What sections should a software design doc include?▼

The bundled template covers Problem, Challenges, Customer Experience, Goals and Non-Goals, Constraints, Glossary, Key Allies, Strategy with multiple candidate solutions, Common Considerations, Cost, API, Risks, Acknowledgements, plus appendix sections for Schedule, Blockers, and Diagrams.

Does this skill work without the plumbeer-design-reviewer skill?▼

No. It has a hard dependency on plumbeer-design-reviewer, which it invokes through the Skill tool to grade each section against the 24-row checklist. Without that skill available, the gating workflow cannot run and this skill should not be used.

Can I skip a review gate or section I do not need?▼

Yes, but only by explicitly saying so, such as telling it to skip or bypass a gate. The skip is then recorded visibly in the document, for example under Risks and Open Questions, so the gap is never silently hidden from later reviewers.

Can I resume a partially written design doc?▼

Yes. If the target file already exists, the Skill reads it first and runs the reviewer checklist to see which rows are already Met, then resumes from the first unmet row instead of restarting the interview from scratch.