he-spec

Gather requirements through dialogue and generate specification, plan, and task files.

Updated Jul 23, 2025
One-click install
npx skills add https://github.com/data-players/Marker-OCR-API --skill he-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: he-spec
Source: https://github.com/data-players/Marker-OCR-API/tree/main/.heracles/agents/skills/he-spec
Command: npx skills add https://github.com/data-players/Marker-OCR-API --skill he-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill acts as a dedicated facilitator for defining complete functional and technical specifications through structured dialogue, then outputs a ready-to-use specification, technical plan, and task breakdown.

Core Features & Use Cases

  • Dialogue-driven requirement gathering and clarification
  • Generation of a functional spec documenting user stories
  • Creation of a technical plan and task breakdown (plan.md and tasks.md)
  • Scaffolding for implementation with tracked workflow state

Quick Start

Initiate a spec session by answering the guided questions to generate the specification, plan, and tasks.

Frequently Asked Questions about he-spec

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

FAQPage Schema
How do I generate functional and technical specifications from user requirements?▼

To generate functional and technical specifications, you can use a dialogue-driven facilitator that gathers user requirements, clarifies product features, and outputs a specification.md file documenting user stories. It automates the requirement gathering process through structured questions.

What is the best way to break down product features into actionable tasks and plans?▼

Breaking down product features into actionable tasks is achieved by decomposing initial concepts into a technical plan and task breakdown. This process produces plan.md and tasks.md files, scaffolding implementation with tracked workflow state updates.

Can I document user stories and technical plans without manual formatting?▼

Documenting user stories and technical plans without manual formatting is possible through automated specification generation. The tool coordinates dialogue and artifacts to produce ready-to-use markdown files for specification, planning, and task tracking.

Does structured requirement gathering work for product features from initial concept to implementation?▼

Structured requirement gathering works for product features from initial concept through decomposition into plans and actionable tasks. It applies dialogue-driven clarification to define complete specifications and updates WORKFLOW_STATE.md to reflect spec_complete when finished.