Optimize for learning, not shipping the prototype. Match fidelity to the single question under test; time-box in hours or days; discard artifacts once the hypothesis is answered.
When to Use
Uncertainty is high on UX, feasibility, performance, or integration risk.
Stakeholders confuse “demo” with “commitment.”
You need evidence before a large build or refactor.
Workflow
Write one falsifiable question (e.g., “Will users complete setup without docs?”).
Choose fidelity: paper sketch → wireframe → clickable mock → thin code spike → broader MVP—only as high as the question demands.
Time-box ruthlessly; scope the prototype to exercise only the risk.
Run the test, log pass/fail and surprises, then throw away or archive—do not let the spike become accidental production.
Examples
Example 1: API doubt: spike the slowest external call path in isolation before designing caching everywhere.
Example 2: Layout risk: one clickable screen for the critical path before building the full component library.
1---2name: prototyping3description: Prototyping4---5# Prototyping67Optimize for **learning**, not shipping the prototype. Match fidelity to the single question under test; time-box in hours or days; discard artifacts once the hypothesis is answered.89## When to Use10- Uncertainty is high on UX, feasibility, performance, or integration risk.11- Stakeholders confuse “demo” with “commitment.”12- You need evidence before a large build or refactor.1314## Workflow151. Write **one** falsifiable question (e.g., “Will users complete setup without docs?”).162. Choose fidelity: paper sketch → wireframe → clickable mock → thin code spike → broader MVP—only as high as the question demands.173. Time-box ruthlessly; scope the prototype to exercise **only** the risk.184. Run the test, log pass/fail and surprises, then **throw away** or archive—do not let the spike become accidental production.1920## Examples21**Example 1:** API doubt: spike the slowest external call path in isolation before designing caching everywhere.2223**Example 2:** Layout risk: one clickable screen for the critical path before building the full component library.
Run npx skillmds@latest add sethdford/prototyping in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Prototyping It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
sethdford (@sethdford) published this skill. Their other Agent Skills are listed on their SkillMD profile.