spec

Interview users to create structured plans and file GitHub epics with linked child issues.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/smallorbit/smallorbit-plugins --skill spec-smallorbit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/smallorbit/smallorbit-plugins/tree/main/plugins/speckit/skills/spec
Command: npx skills add https://github.com/smallorbit/smallorbit-plugins --skill spec-smallorbit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interview the user to fully understand a change, fix, or feature; develop a structured plan; then file the plan as a GitHub epic with linked child issues.

Core Features & Use Cases

  • Orchestrates end-to-end discovery, planning, and governance for changes, fixes, or features.
  • Generates a structured plan from an interview, including goals, background, requirements, and tasks; creates a GitHub epic and linked child issues.
  • Supports handoff to catalogs and epic tracking, with downstream wiring of dependencies and team assignments.

Quick Start

Start the process by triggering /spec and describing the change.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn feature requirements into a structured GitHub epic with linked issues?

To generate a GitHub epic with child issues, this skill conducts an interactive interview to capture feature requirements, translates the insights into a structured plan, and automatically files the epic with linked tasks on GitHub.

What's the best way to plan a software feature before creating a GitHub epic?

The best way to plan a feature for a GitHub epic is through a guided interview that extracts goals and background, develops a structured plan, and then coordinates end-to-end governance by wiring downstream dependencies and team assignments.

How does an interview-driven workflow help with software feature planning?

An interview-driven workflow for software feature planning works by orchestrating discovery questions to fully understand a change, synthesizing the answers into a structured plan with requirements, and filing it directly as a GitHub epic.

Can I create a GitHub epic and automatically link child issues from a single planning workflow?

Yes, you can create a GitHub epic and automatically link child issues by triggering the planning workflow, which generates the structured task list and handles the GitHub integration to file the epic and its dependencies in one end-to-end process.

Do I need to prepare a project plan before starting the interview to file a GitHub epic?

No, you do not need to prepare a project plan before starting the interview; the workflow is designed to extract goals, background, and requirements directly from your answers to build the structured plan for the GitHub epic from scratch.

Does this workflow support wiring downstream dependencies for GitHub child issues?

Yes, the workflow supports wiring downstream dependencies for GitHub child issues by handing off to epic tracking, allowing you to manage task dependencies and team assignments after the epic and linked issues are created.