skills.rest
dvy1987
dvy1987COMMUNITY
Explore all skills by this author →
WebsiteGitHub

problem-to-plan

Convert ambiguous problems into mini-specs, implementation plans, and agent-executable TODOs.

3|Updated Apr 5, 2026
Search Tags:#planning#spec#todo#task-decomposition#implementation-plan#agent-ready
One-click install
npx skills add https://github.com/dvy1987/agent-loom --skill problem-to-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: problem-to-plan
Source: https://github.com/dvy1987/agent-loom/tree/main/.agents/skills/problem-to-plan
Command: npx skills add https://github.com/dvy1987/agent-loom --skill problem-to-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert ambiguous user requests, bug reports, or feature ideas into concrete, actionable planning artifacts so engineering teams and agents can execute work without back-and-forth clarification. The Skill prevents vague planning, ensures measurable success criteria, and produces artifacts that map directly to repository files.

Core Features & Use Cases

  • Mini-spec generation: Create a concise problem statement with scope, success criteria, constraints, and affected files suitable for docs/specs/.
  • Implementation-ready plans: Produce phased, file-specific tasks with Definitions of Done that developers or agents can follow.
  • Agent-executable TODOs: Emit a TODO.md with independent, agent-pickable tasks and milestones that reference exact file paths.
  • Use case: Turn a reported crash or feature request into a dated spec, a step-by-step plan, and a TODO that CI-driven agents can pick up.

Quick Start

Plan this change: convert the described problem into a mini-spec, an implementation-ready plan, and an agent-executable TODO with file-specific tasks.

Frequently Asked Questions about problem-to-plan

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

FAQPage Schema
How do I convert a bug report into an implementation plan and TODO?▼

To convert a bug report into an implementation plan, the Skill analyzes the problem and outputs a mini-spec, phased implementation plan, and agent-executable TODO. It maps file-specific tasks with Definitions of Done directly to repository paths.

Can I create agent-ready task lists from ambiguous feature ideas?▼

Yes, you can create agent-ready task lists from ambiguous feature ideas. The Skill emits a TODO.md with independent, agent-pickable tasks and milestones that reference exact file paths for autonomous execution.

What is the best way to write a mini-spec for a software project?▼

The best way to write a mini-spec for a software project is to define a concise problem statement with scope, success criteria, constraints, and affected files. This Skill automates that process, constraining clarifying questions to three.

Does this planning Skill work for CI-driven agents?▼

Yes, this planning Skill works for CI-driven agents by producing agent-executable TODOs with measurable success criteria. The generated TODO.md contains independent tasks that agents can pick up directly.

Why limit clarifying questions when generating a spec and plan?▼

Limiting clarifying questions to three when generating a spec and plan prevents vague planning and reduces back-and-forth clarification. This ensures engineering teams and agents receive concrete, actionable artifacts for immediate execution.

Related Skills

Explore More Software Engineering Skills→
browseros-aibrowseros-ai
50

dev3-prd

Generate targeted questions from feature requests and resolve them via codebase inspection.

Official
Advanced
GabeujinGabeujin

create-implementation-plan

Generate machine-readable implementation plans with phases, tasks, and dependencies.

Community
Intermediate
rustyrazorbladerustyrazorblade
38

openspec-consolidate-specs

Identify overlapping OpenSpec specifications and propose consolidated merges.

Community
Advanced
patrickrmoorepatrickrmoore

generate-tasks

Decompose implementation plans into dependency-ordered task lists in tasks.md.

Community
Intermediate