issue-to-tasks

Break issue descriptions into ordered, typed AI-executable tasks.

1|Updated May 11, 2026
One-click install
npx skills add https://github.com/skalanux/puntofiles --skill issue-to-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-to-tasks
Source: https://github.com/skalanux/puntofiles/tree/main/dot_agents/skills/issue-to-tasks
Command: npx skills add https://github.com/skalanux/puntofiles --skill issue-to-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of turning a vague or large issue description into a concrete, step-by-step task plan that an AI can execute in focused passes.

Core Features & Use Cases

  • Breaks down work into one-session chunks: Produces tasks that are completable in a single AI interaction with clear, verifiable outputs.
  • Orders tasks by dependency: Encourages schema first, then logic, then API, then UI, with tests interleaved appropriately.
  • Supports realistic planning for codebase changes: Guides exploring affected files, naming/error/test conventions, and contract constraints (without changing the referenced parent PRD/issue).

Quick Start

Ask the skill to read your issue (by number, URL, or file) and produce an approved task list template for implementing it.

Frequently Asked Questions about issue-to-tasks

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

FAQPage Schema
How do I break down a GitHub issue into AI-executable tasks?

Decomposing a vertical-slice change into manageable sessions involves applying dependency-aware task sequencing. The tool encourages schema first, then logic, then API, then UI, with tests interleaved appropriately.

How does dependency-aware task sequencing work for software tickets?

The tool validates task order and size through an iterative user quiz. This ensures each planned chunk is completable in a single AI interaction with clear, verifiable outputs.

Can I use a PRD-linked issue to generate a step-by-step task plan?

It guides exploring affected files, naming conventions, error handling, test conventions, and contract constraints to support realistic planning for codebase changes.

What is the best way to plan codebase changes for vertical-slice implementation?

It applies typed task labels such as WRITE, TEST, MIGRATE, CONFIG, and REVIEW to categorize each step, ensuring clear expectations for the AI execution phase.

Does task planning for AI workflows require validating the size of each ticket?

This validation process guarantees that the generated tasks have clear, verifiable outputs and are effectively sized for focused AI execution passes.