issue-refinement

Transform a PRD into standalone issue Markdown files in specs/issues.

Updated Mar 9, 2023
One-click install
npx skills add https://github.com/rogvid/dotfiles --skill issue-refinement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-refinement
Source: https://github.com/rogvid/dotfiles/tree/main/opencode/.config/opencode/skill/issue-refinement
Command: npx skills add https://github.com/rogvid/dotfiles --skill issue-refinement

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines turning high-level PRDs into self-contained, executable issue Markdown files so fresh agents can autonomously implement tasks.

Core Features & Use Cases

  • Transforms a PRD into multiple focused issue files in specs/issues, preserving traceability to the source PRD.
  • Generates self-contained task descriptions with frontmatter, context, and clear acceptance criteria suitable for zero-context execution.
  • Validates dependencies and branching strategy to ensure correct execution order and isolation.

Quick Start

Run the issue-refinement workflow on a PRD file to generate standalone issue markdowns in specs/issues.

Frequently Asked Questions about issue-refinement

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

FAQPage Schema
How do I convert a PRD into executable issue files for autonomous agents?

To convert a PRD into executable issue files, this skill transforms the document into standalone Markdown files in specs/issues. It generates self-contained tasks with frontmatter, context, and verifiable acceptance criteria suitable for zero-context execution by fresh agents.

What is the best way to split a large PRD into focused development tasks?

The best way to split a large PRD into focused development tasks is by generating task-sized standalone issue files. This skill enforces dependency ordering and preserves traceability to the source PRD, ensuring correct execution order and isolation for each generated issue.

How do I structure Markdown issues for zero-context agent execution?

To structure Markdown issues for zero-context agent execution, you need frontmatter requirements, context, and clear acceptance criteria. This skill enforces these structural validations automatically, ensuring every generated issue file contains all necessary information for autonomous implementation.

Does this issue generation approach validate dependencies and branching strategy?

Yes, this issue generation approach validates dependencies and branching strategy. It enforces dependency ordering to ensure correct execution order and validates branching to maintain isolation, guaranteeing that task-sized issues can be executed independently by fresh agents.

When do I need to generate standalone issue files from project requirements?

You need to generate standalone issue files from project requirements when transitioning from high-level planning to autonomous implementation. This skill streamlines this phase by creating self-contained task descriptions with verifiable acceptance criteria, eliminating the need for agents to interpret the full PRD.