intake-spec

Converts free-form text into a structured spec.md document with interactive clarification.

1|Updated Jul 5, 2026
One-click install
npx skills add https://github.com/stoodder/materia --skill intake-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intake-spec
Source: https://github.com/stoodder/materia/tree/main/plugins/materia/skills/intake-spec
Command: npx skills add https://github.com/stoodder/materia --skill intake-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps transform raw product specifications or feature requests into structured and testable documents, simplifying the initial stages of the development process.

Core Features & Use Cases

  • Structured Specification Creation: Converts free-form text into a precise spec.md document, ensuring all necessary details are included.
  • Clarifying Questions: Engages with the user to resolve any ambiguities or gaps in the initial specification.
  • Use Case: For a project manager looking to refine a product spec from a verbal description or an initial draft, this Skill provides a structured template and interactive questions to guide the development of a complete and testable specification.

Quick Start

Initiate the intake-spec Skill with the command: /materia:run intake-spec "Initial spec description here". This will start the process of structuring your specification.

Frequently Asked Questions about intake-spec

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

FAQPage Schema
How do I convert free-form text into a structured specification document?

To convert free-form text into a structured specification document, you provide your raw feature request to the Skill, which then generates a precise spec.md file. It engages with you interactively to resolve ambiguities and ensure completeness.

What is the best way to refine a product spec from an initial draft?

The best way to refine a product spec from an initial draft is using an interactive clarification process that identifies gaps. This ensures your structured documentation becomes complete and testable before development begins.

How do I ensure my feature request is testable for product development?

You ensure a feature request is testable for product development by transforming it into a structured specification document. The Skill asks clarifying questions to fill gaps, guaranteeing the final spec is actionable.

Do I need any dependencies to automate structured documentation creation?

No dependencies are required to automate structured documentation creation. The Skill operates independently to parse your raw product specifications and generate a testable spec.md file.

Can I use a verbal description to start project management specification creation?

Yes, you can use a verbal description to start project management specification creation. The Skill accepts initial spec descriptions as free-form text and structures them into a formal document.