spec

Convert a broad intent into a detailed software specification through a five-phase process.

127k|19.1k|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/garrytan/gstack --skill spec-garrytan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/garrytan/gstack/tree/main/spec
Command: npx skills add https://github.com/garrytan/gstack --skill spec-garrytan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, Read, Grep, Glob, AskUserQuestion, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps transform a broad, non-specific intent into a detailed, actionable software specification, ensuring clarity and precision in project requirements.

Core Features & Use Cases

  • Five-Phase Spec Process: Guides the user through a structured process to refine their intent into a complete specification.
  • Trigger Phrases: Can be invoked using phrases like "spec this out", "file an issue", or "turn this into a backlog item".
  • Integration: Files issues and optionally spawns a Claude Code agent in a fresh worktree for further development.

Quick Start

To spec out a new feature, simply type 'spec this out' in your project context.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn a vague project idea into a detailed software specification?

You can convert a vague project intent into a detailed software specification by using a structured five-phase requirement gathering process. This approach refines broad ideas into actionable project planning items, ensuring clarity and precision in development requirements.

What is the best way to file an issue for a new feature backlog item?

The best way to file an issue for a new feature backlog item is to use a structured specification process triggered by phrases like 'file an issue'. This approach converts your intent into a precise spec and logs the requirement for project tracking.

How does requirement gathering work for software development project planning?

Requirement gathering for software development works by guiding users through a structured five-phase process to refine broad intents into executable specifications. It supports project planning by ensuring all requirements are detailed and actionable before development begins.

Can I spawn a development agent automatically after creating a software specification?

Yes, you can optionally spawn a Claude Code agent in a fresh worktree immediately after finalizing your software specification. This integration automates the transition from project planning and requirement gathering directly into executable development.

Do I need Bash and Glob tools to create an executable project specification?

Yes, creating an executable project specification requires Bash, Read, Grep, Glob, and AskUserQuestion tools for execution. These dependencies allow the specification process to interact with your project files and gather precise requirements dynamically.