to-issues

Breaks plans and specs into vertical-slice issues on a project issue tracker.

Updated Jul 4, 2024
One-click install
npx skills add https://github.com/hareki/dotfiles --skill to-issues-hareki
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: to-issues
Source: https://github.com/hareki/dotfiles/tree/main/agents/.agents/skills/to-issues
Command: npx skills add https://github.com/hareki/dotfiles --skill to-issues-hareki

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a large plan, spec, or PRD into actionable work items is hard: horizontal task breakdowns create issues that cannot be demoed or verified independently. This Skill decomposes plans into tracer-bullet vertical slices and publishes them as ready-to-grab issues on the project issue tracker. ## Core Features & Use Cases - Vertical Slice Breakdown: Splits a plan into thin end-to-end slices that cut through all layers (schema, API, UI, tests) so each issue is independently demoable. - Interactive Refinement: Presents the proposed breakdown with titles, dependencies, and covered user stories, then iterates with the user until the granularity and blocking relationships are approved. - Issue Tracker Publishing: Creates issues in dependency order using a structured template with acceptance criteria and "Blocked by" references, applying the correct triage label for AFK agents. - Use Case: After drafting a PRD for a new feature, run this Skill to convert it into a sequence of small, independently completable issues that team members or autonomous agents can pick up immediately. ## Quick Start Ask the AI to break the current plan or spec into vertical-slice issues and publish them to the issue tracker.

Frequently Asked Questions about to-issues

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

FAQPage Schema
How do I break a PRD or spec into issues for my team?▼

Provide the plan, spec, or PRD in the conversation and invoke the Skill. It drafts tracer-bullet vertical slices, quizzes you on granularity and dependencies, then publishes approved issues to your issue tracker in dependency order.

What is a vertical slice or tracer bullet issue?▼

A vertical slice is a thin but complete path through every layer of the system, such as schema, API, UI, and tests, rather than a horizontal slice of one layer. Each completed slice is demoable or verifiable on its own.

Can I convert an existing issue into smaller sub-issues?▼

Yes. Pass an issue number, URL, or path as an argument and the Skill fetches the full body and comments from the tracker, then breaks it into slices that reference the original as a parent issue.

Does the Skill modify or close the parent issue?▼

No. The Skill explicitly does not close or modify any parent issue. It only creates new child issues that reference the parent in their body template.

What setup is required before using this issue breakdown workflow?▼

The issue tracker and triage label vocabulary must already be configured, typically by running the setup-matt-pocock-skills command. Without it, the Skill cannot publish issues with the correct triage labels.