dev-issues

Decompose unstructured brain-dumps into discrete issue files with collision-checking.

118|12|Updated May 5, 2026
One-click install
npx skills add https://github.com/alecs5am/ralphy --skill dev-issues
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-issues
Source: https://github.com/alecs5am/ralphy/tree/main/.agents/skills/dev-issues
Command: npx skills add https://github.com/alecs5am/ralphy --skill dev-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn a free-form brain-dump into a clean, ordered set of notes/issues work items. The user tags /dev-issues and writes a long stream of everything in their head — features, refactors, bugs, half-formed ideas, product direction. This skill decomposes that stream into discrete, well-shaped, individually-actionable issue files, asks clarifying questions only where a decision is genuinely the user's, collision-checks against the existing notes inbox so it updates rather than duplicates, then commits the batch. The end state: every thought is captured as an issue a downstream agent (or /dev-loop) can pick up and execute.

Core Features & Use Cases

  • Decomposes a brain-dump into discrete issues
  • Collision-checks against existing notes/issues to avoid duplicates
  • Pairs with the dev-loop to execute the issues
  • Commits the batch to notes/issues

Quick Start

Tag your input with /dev-issues and write a long brain-dump to start converting it into tracked issues.

Frequently Asked Questions about dev-issues

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

FAQPage Schema
How do I convert unstructured brain-dumps into actionable development issues?▼

To convert unstructured brain-dumps into actionable development issues, this skill decomposes long-form text streams into discrete issue files. It applies strict collision-checking against existing notes and enforces concrete scope and acceptance criteria to enable downstream execution.

What is the best way to track feature ideas and refactor notes without creating duplicates?▼

Tracking feature ideas and refactor notes without duplicates requires collision-checking against an existing notes inbox. This process updates overlapping items rather than duplicating them, ensuring a clean, ordered set of individually-actionable issue files.

How does issue decomposition handle half-formed ideas in a brainstorm?▼

Issue decomposition handles half-formed ideas by breaking down long-form brainstorms into discrete, well-shaped work items. It asks clarifying questions only where a genuine decision is required, capturing every thought as an issue a downstream agent can execute.

Can I use these generated issues directly with my development loop?▼

You can use these generated issues directly with your development loop. Each issue file enforces monotonic numbering and concrete acceptance criteria, producing notes specifically designed for a downstream agent or dev-loop to pick up and execute.

Does converting a brain-dump into tracked issues require manual batch formatting?▼

Converting a brain-dump into tracked issues does not require manual batch formatting. You simply tag an unstructured stream of features, bugs, and ideas, and the system automatically structures, collision-checks, and commits the batch of notes.

What limitations exist when decomposing long-form text into issue files?▼

A limitation when decomposing long-form text into issue files is that the process enforces strict collision-checking and monotonic numbering at a flat top level. It will pause to ask clarifying questions only where a decision is genuinely yours to make.