translating-shape-to-spec

Converts shaped intent and breadboard data into a draft functional specification with traceability.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ReadyStateChange/agents --skill translating-shape-to-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translating-shape-to-spec
Source: https://github.com/ReadyStateChange/agents/tree/main/skills/translating-shape-to-spec
Command: npx skills add https://github.com/ReadyStateChange/agents --skill translating-shape-to-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts shaped intent and breadboard data into a draft, traceable functional specification to ground development and testing.

Core Features & Use Cases

  • Maps each requirement to observable behavior to ensure verifiability.
  • Surfaces translation decisions, traceability notes, and open questions for review.
  • Produces a draft functional spec with verification references and decision log.

Quick Start

Provide a selected shape and breadboard artifacts to generate a draft, traceable spec.

Frequently Asked Questions about translating-shape-to-spec

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

FAQPage Schema
How do I convert shaped intent into a draft functional specification?

To convert shaped intent into a draft functional specification, provide your selected shape and breadboard artifacts. The process maps requirements to observable behavior, ensuring verifiability while generating traceability notes and decision logs.

How do I generate requirement-to-spec traceability for breadboard outputs?

Requirement-to-spec traceability is generated by mapping each requirement to observable behavior and verification references. This records translation decisions and open questions alongside the breadboard data within the draft specification output.

What is a traceable functional specification and when do I need one?

A traceable functional specification maps each requirement to observable behavior, verification references, and decision logs. You need one when a shape and breadboard outputs exist and a draft spec is required before refinement to ground development and testing.

Does translating shapes to specs require existing breadboard data?

Yes, translating shapes to specs requires existing breadboard data and a selected shape. These artifacts are prerequisites that the tool processes to surface translation decisions, acceptance criteria, and open questions for review.

What is the best way to document open questions during requirements translation?

The best way to document open questions during requirements translation is to process shaped intent and breadboard data together. This automatically surfaces open questions, acceptance criteria, and translation decisions within the draft specification.

Can I use this translation process before spec refinement?

Yes, you can use this translation process before spec refinement. It specifically applies when a draft spec is needed, producing a baseline with decision logging and open questions to guide subsequent refinement and testing activities.