skills.rest
smarmen86
smarmen86COMMUNITY
Explore all skills by this author →
GitHub

spec

Generate executable GitHub issues from vague intent through a five-phase workflow.

Updated Jun 5, 2026
Search Tags:#automation#planning#github#specification#issue tracking#backlog
One-click install
npx skills add https://github.com/smarmen86/claude-code-kit --skill spec-smarmen86
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/smarmen86/claude-code-kit/tree/main/skills/spec
Command: npx skills add https://github.com/smarmen86/claude-code-kit --skill spec-smarmen86

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the ambiguity in early-stage project planning by forcing a structured, five-phase process to turn loose intent into a concrete, executable GitHub issue or ticket.

Core Features & Use Cases

  • Structured Specification: Guides the creation of technical requirements, ensuring no critical details are missed.
  • Workflow Integration: Automatically handles issue filing and can spawn isolated worktrees for immediate implementation.
  • Use Case: When a team member suggests a new feature, use this skill to generate a formal backlog item that includes scope, technical constraints, and success criteria.

Quick Start

Invoke the spec skill to turn the current project requirements into a formal GitHub issue.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn vague project ideas into precise GitHub issues?▼

To turn vague ideas into precise GitHub issues, this skill applies a structured five-phase workflow that refines loose intent into formal backlog items containing scope, technical constraints, and success criteria. It directly outputs executable specifications.

What is the best way to create actionable technical specifications from loose requirements?▼

Creating actionable technical specifications is best handled by forcing early-stage project planning through a structured process, preventing ambiguity by ensuring no critical details are missed when defining technical requirements and success criteria for backlog items.

Can I automate issue tracking and worktree management from a feature request?▼

Yes, you can automate issue tracking and worktree management from feature requests. The workflow integration handles automatic GitHub issue filing and can spawn isolated worktrees to enable immediate implementation of the newly defined specification.

Does this specification workflow support automated backlog generation for software engineering tasks?▼

Yes, this specification workflow supports automated backlog generation for software engineering tasks. It converts user intent into formalized tickets that satisfy requirements for standardized documentation and project management automation.

When do I need a structured process for converting ideas into backlog items?▼

You need a structured process for converting ideas into backlog items when early-stage project planning suffers from ambiguity. If loose intent risks missing critical technical constraints, a forced five-phase workflow ensures precise, executable specifications.

Related Skills

Explore More Product & Management Skills→
hujianbesthujianbest
51

hf-frame

Define project scope and risk during HarnessFlow's Frame stage.

Community
Intermediate
LSailerLSailer
1

Ralph Loop

Automate GitHub issue development from TDD implementation to pull request creation.

Community
Advanced
e2itse2its
1

factory-backlog-next-task

Parse execution plans and linked issues to compute the next backlog task.

Community
Advanced
danilodsdanilods

sysdesign-interview-flow-50min

Runs a 50-minute five-phase session producing a complete design specification.

Community
Advanced