to-design

Transform PRDs or rough ideas into Go-style design documents with tradeoff analysis.

207|30|Updated May 16, 2026
One-click install
npx skills add https://github.com/smallnest/goal-workflow --skill to-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-design
Source: https://github.com/smallnest/goal-workflow/tree/main/skills/to-design
Command: npx skills add https://github.com/smallnest/goal-workflow --skill to-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a PRD or rough product idea into a clear design document that explains the chosen approach, the tradeoffs, and the reasons behind them before implementation starts.

Core Features & Use Cases

  • Writes Go-style design proposals with Abstract, Background, Design, Rationale, Compatibility, and Implementation sections.
  • Surfaces real decision forks, alternatives, and migration concerns so teams can align on why one approach wins.
  • Best for features that affect architecture, APIs, compatibility, or cross-team coordination, such as refactors, platform changes, or new product flows.

Quick Start

Use the to-design skill to draft a design proposal from this PRD and call out the key tradeoffs, compatibility risks, and implementation plan.

Frequently Asked Questions about to-design

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

FAQPage Schema
How do I turn a PRD into a design document with tradeoff analysis?

To turn a PRD into a design document, you transform the product requirements into a Go-style proposal that includes background, design, rationale, compatibility, and implementation sections while highlighting real decision forks and migration concerns.

What is a Go-style design proposal and when do I need one for software architecture?

A Go-style design proposal is a decision-focused document structured with abstract, background, design, rationale, compatibility, and implementation sections. You need one for software features affecting architecture, APIs, or cross-team coordination before implementation begins.

How do I plan compatibility and migration risks for a platform refactor?

Plan compatibility and migration risks for a platform refactor by drafting a design document that surfaces real decision forks, alternatives, and migration concerns, ensuring teams align on why the chosen approach wins before implementation starts.

Can I use this design proposal format for rough product ideas instead of formal PRDs?

Yes, you can use this format for rough product ideas. The process transforms either a formal PRD or a rough idea into a clear design proposal that explains the chosen approach, tradeoffs, and reasons behind them for architecture decisions.

What should be included in the rationale section of a software design doc?

The rationale section of a software design doc should include the tradeoffs, alternatives, and the specific reasons behind why one approach wins over others, ensuring teams align on the architecture decisions before implementation.

When should I avoid writing a design proposal before implementation?

You should avoid writing a detailed design proposal for simple features that do not affect architecture, APIs, compatibility, or cross-team coordination, as the overhead of tradeoff analysis and migration planning provides minimal value for isolated changes.