to-issues

Decomposes plans into vertical-slice GitHub issues ordered by dependencies.

138|5|Updated Sep 19, 2024
One-click install
npx skills add https://github.com/macalbert/envilder --skill to-issues-macalbert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-issues
Source: https://github.com/macalbert/envilder/tree/main/.github/skills/to-issues
Command: npx skills add https://github.com/macalbert/envilder --skill to-issues-macalbert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a roadmap, PRD, or feature plan into actionable GitHub issues often produces horizontal slices that delay feedback and block parallel work. This Skill converts plans into thin vertical slices that are independently testable, mergeable, and deliver observable value. ## Core Features & Use Cases - Vertical Slicing: Each issue is a tracer bullet touching all layers (domain, application, infrastructure, entry point) rather than horizontal slices like "add all domain entities". - Dependency Ordering: Issues are numbered in implementation order, with the first issue being the thinnest possible end-to-end path. - Structured Issue Format: Generates titles in Conventional Commit format with acceptance criteria, test commands, and technical notes referencing ADRs. - Use Case: Given a ROADMAP.md entry for a new SDK provider, produce a numbered table of up to 8 issues, get user approval, then create them via gh issue create. ## Quick Start Ask the assistant to break the current plan or ROADMAP.md entry into vertical-slice GitHub issues using the to-issues skill.

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 feature plan into GitHub issues?

Slice the plan vertically so each issue is a tracer bullet touching all layers from domain to entry point. Order issues by dependency, format them with acceptance criteria and test commands, then create them with gh issue create after user approval.

What is a vertical slice in issue decomposition?

A vertical slice is a thin end-to-end piece of work that touches all necessary layers and delivers observable value on its own. It contrasts with horizontal slices like adding all domain entities at once, which delay feedback and integration.

How many issues should a single plan produce?

A plan should produce at most 8 issues, each representing no more than one day of work. If more are needed, split the work into phases; if an issue is too large, slice it thinner.

Can I create GitHub issues from the command line?

Yes, the GitHub CLI supports issue creation via gh issue create. This workflow presents the full issue list as a numbered table for approval first, then creates the confirmed issues with the needs-triage label by default.

When should I not use vertical slicing for issues?

Vertical slicing is less suitable when the plan is still vague or scope boundaries are unclear. In that case, clarify scope first with a few targeted questions and check the roadmap and existing issues for overlap before slicing.