doit.specit

Convert natural-language feature descriptions into structured specifications with acceptance criteria.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/seanbarlow/doit --skill doit-specit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doit.specit
Source: https://github.com/seanbarlow/doit/tree/main/.claude/skills/doit.specit
Command: npx skills add https://github.com/seanbarlow/doit --skill doit-specit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a complete feature specification from a natural language description, enabling you to capture requirements, acceptance criteria, scope, and integration considerations for planning and execution.

Core Features & Use Cases

  • Spec generation: Produce a structured spec with sections like Summary, Requirements, Acceptance Criteria, and testing guidance.
  • Research integration: Leverage project context from prior /doit.researchit artifacts (research.md, user-stories.md, personas.md) to steer the spec and resulting user stories.
  • Traceability & governance: Map user stories to personas and maintain traceability data, including Persona Coverage and traceability tables.
  • GitHub integration: Optionally create Epic and Feature issues to advance planning and alignment with the repo.
  • Quality assurance: Run a structured validation checklist to ensure completeness before planit, including handling needs clarifications.
  • Visualizations: Generate Mermaid diagrams for user journeys and entity relationships to illustrate flows and data models.

Quick Start

Provide a feature description to generate a complete specification ready for planning.

Frequently Asked Questions about doit.specit

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

FAQPage Schema
How do I turn a feature idea into a ready-to-plan specification?

A feature specification includes structured sections for Summary, Requirements, Acceptance Criteria, and testing guidance, transforming natural-language descriptions into plan-ready documents with scope and integration considerations.

Can I generate GitHub issues directly from my feature spec?

Yes, the feature specification process optionally creates Epic and Feature GitHub issues directly from the generated spec to advance planning and align requirements with your repository.

How do I incorporate existing user stories and personas into a new feature spec?

You incorporate existing research by leveraging prior research, user-stories, and personas artifacts to steer the spec, map user stories to personas, and maintain traceability tables for governance.

Does feature specification generation include quality checks before planning?

Yes, feature specification generation runs a structured validation checklist to ensure completeness before planning, verifying that all requirements and acceptance criteria are fully captured.

What is the best way to visualize user journeys within a feature specification?

The best way to visualize user journeys within a feature specification is to generate Mermaid diagrams, which illustrate user flows and entity relationships directly within the plan-ready document.