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.