autospec-define

Plan a feature into a design spec and linked GitHub issue queue.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/berlinguyinca/autospec --skill autospec-define
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autospec-define
Source: https://github.com/berlinguyinca/autospec/tree/main/skills/autospec-define
Command: npx skills add https://github.com/berlinguyinca/autospec --skill autospec-define

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, git, gh, jq, bash, and includes scripts (resource) components.

What problem does it solve?

Turns a feature idea into a durable, reviewable design spec and a linked GitHub issue tree that an implementation agent can execute. It reduces the risk of vague requirements by forcing structured architecture, API, data model, errors, and testing into a spec before code changes begin. It also ensures work is explainable after the fact by stopping at the planning phase and handing off to implementation.

Core Features & Use Cases

  • Phase 0–3 Planning Pipeline: bootstraps a repo if missing, investigates the codebase, produces a structured design spec, then decomposes the spec into an epic plus sized child issues.
  • Existing Spec Mode: selects a tracked docs/specs/*.md design doc, skips research/design, and decomposes it into the same issue queue structure.
  • Handoff to Implementation: stops after Phase 3 with a clear instruction to continue using /autospec-run for autonomous implementation and PR creation.

Quick Start

Invoke autospec-define with your feature request to generate a design spec in docs/specs and a linked GitHub issue queue, then continue by running /autospec-run --profile <name>.

Frequently Asked Questions about autospec-define

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

FAQPage Schema
How do I decompose a feature design spec into linked GitHub issues for implementation?

Decompose a design spec by selecting a tracked docs/specs/*.md file, skipping research and design phases, and splitting it into a structured GitHub issue queue containing an epic plus sized child issues ready for implementation handoff.

What's the best way to plan a feature from idea to implementation-ready issue tree?

Plan a feature through a Phase 0–3 pipeline that bootstraps the repo, investigates the codebase, produces a structured design spec covering architecture and data models, and decomposes it into linked GitHub issues before implementation begins.

Do I need git and gh CLI installed to generate a design spec and issue queue?

Yes, you need git, gh CLI, curl, jq, and bash installed to bootstrap repositories, create GitHub issues, query API responses, and execute the planning pipeline that generates design specs and linked issue trees.

Can I skip the research phase and split an existing design doc into GitHub issues?

Yes, existing spec mode selects a tracked docs/specs/*.md design document, skips research and design phases entirely, and decomposes the already-written spec into the same epic plus child issue queue structure for implementation handoff.

Why does the planning pipeline stop before implementation and require YAML frontmatter?

The pipeline stops after Phase 3 to ensure work remains reviewable and explainable, handing off execution to /autospec-run for autonomous implementation. YAML frontmatter metadata is required to track spec availability and structure the design doc.

What should I do after the design spec and GitHub issue queue are generated?

After Phase 3 completes, continue by running /autospec-run with a profile name to autonomously implement the planned issues, create pull requests, and execute the structured design spec without manual intervention.