to-spec

Generate a feature specification covering context, goals, risks, and testing.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/arthur-debert/dodot --skill to-spec-arthur-debert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/arthur-debert/dodot/tree/main/.agents/skills/to-spec
Command: npx skills add https://github.com/arthur-debert/dodot --skill to-spec-arthur-debert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn an early product idea, conversation, or rough codebase understanding into a structured, authoritative feature spec so the team can align before deeper architectural decisions are made.

Core Features & Use Cases

  • Spec creation: Produces a complete planning artifact covering context, problem, goals, non-goals, risks, and testing.
  • Planning workflow fit: Designed for the first planning step, before an architectural review or ticket breakdown.
  • Use Case: Use this Skill when you have a blessed overview or rough idea and need a single source of truth for what should be built, why it matters, and how success will be verified.

Quick Start

Ask the assistant to turn your current product idea and repository context into a spec and write it to docs/spec as the first planning artifact.

Frequently Asked Questions about to-spec

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

FAQPage Schema
How do I create a feature spec from a product idea?

To create a feature spec, you provide a product idea and repository context so the tool can generate an authoritative document covering context, problem, goals, non-goals, risks, and testing. This structured output serves as the first planning artifact.

What is the best way to structure product requirements for early planning?

Structuring product requirements for early planning requires covering context, problem, goals, non-goals, proposed shape, stories, risks, and testing. This comprehensive coverage ensures team alignment before deeper architectural decisions.

When do I need a feature specification before architectural review?

You need a feature specification before architectural review when a team requires a first-pass planning artifact to align on what should be built, why it matters, and how success will be verified prior to ticket creation.

How to write product requirements that include non-goals and risks?

Writing product requirements with non-goals and risks involves transforming conversation context and codebase understanding into a complete spec. This ensures structured coverage of boundaries and potential issues before development begins.

Can I use a generated spec for ticket creation workflows?

Yes, you can use a generated spec for ticket creation workflows. It is designed as the first planning step to establish a single source of truth, providing the necessary structure before proceeding to ticket breakdown.

What should be included in a feature definition for roadmap planning?

A feature definition for roadmap planning should include context, problem, goals, non-goals, proposed shape, stories, risks, testing, and follow-up notes. This ensures an authoritative specification for the team.