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.