How does the automatic subtask breakdown work?

The skill analyzes the markdown hierarchy (headers and lists) to identify distinct implementation steps, creating up to three levels of depth: Epics, Tasks, and Subtasks.

Does it preserve code snippets from the original document?

Yes, when breaking down tasks, the skill extracts relevant section content, including code snippets and file paths, and includes them in the task description.

What markdown files are supported by dex-plan?

It supports any markdown file containing planning or design content, including SPEC.md, DESIGN.md, ARCHITECTURE.md, roadmaps, and Claude's internal plan files.

Can I use it with Claude's built-in plan mode?

Yes, it is specifically designed to take plans from ~/.claude/plans/*.md and convert them into trackable dex tasks instantly.

What if my plan is too small for subtasks?

The skill includes decision logic to skip breakdown for exploratory work or short plans (1-2 steps), keeping your task list clean and cohesive.

Dex Plan

Name: Dex Plan
Author: dcramer

bydcramer

•

148

•

生产力与工作流

Converts markdown planning documents into structured, trackable tasks and subtasks within the dex system.

dex-plan streamlines the transition from planning to execution by automatically transforming markdown specifications, design documents, and roadmaps into actionable tasks. It intelligently analyzes the structure of your markdown files—detecting numbered lists, headers, and implementation phases—to create a hierarchical task tree (Epics, Tasks, and Subtasks) within the dex task tracking system. This ensures that every requirement and implementation detail is captured and assigned a unique ID for seamless tracking throughout the development lifecycle.

主要功能

01Support for 3-level task hierarchies including Epics, Tasks, and Subtasks.

02Automated task creation from markdown specs, design docs, and roadmaps.

03Smart context extraction that preserves implementation details and code snippets.

04148 GitHub stars

05Automatic stripping of 'Plan:' prefixes for clean task titles.

06Intelligent subtask breakdown based on document headings and list items.

使用场景

01Converting a Claude-generated plan into trackable, manageable subtasks.

02Turning a SPEC.md or DESIGN.md into a structured implementation checklist.

03Decomposing a high-level roadmap into actionable developer tasks with parent-child relationships.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dcramer/dex dex-plan

For use in Claude.ai and ChatGPT