Dex Plan

Converts markdown planning documents into trackable dex tasks with intelligent subtask breakdown. Point it at any plan file, spec, design doc, or roadmap and it creates a task with the full content as context. The smart part is the automatic analysis: if your plan has 3-7 distinct work items or clear phases, it breaks them into subtasks or even epic-level hierarchies. Single cohesive tasks stay single. Works great after finishing a plan in plan mode or when you've got a SPEC.md that needs to become actionable work. Strips "Plan:" prefixes, supports priorities and parent linking, and handles up to three levels of hierarchy before dex cuts you off.

skills.sh installs: 783
GitHub stars: 408
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add dcramer/dex --skill dex-plan --agent claude-code

Installs into .claude/skills of the current project.

Files

Converting Markdown Documents to Tasks

Command Invocation

Use dex directly for all commands:

dex <command>

If dex is not on PATH, use npx @zeeg/dex <command> instead. Check once at the start:

command -v dex &>/dev/null && echo "use: dex" || echo "use: npx @zeeg/dex"

Use /dex-plan to convert any markdown planning document into a trackable dex task.

When to Use

After completing a plan in plan mode
Converting specification documents to trackable tasks
Converting design documents to implementation tasks
Creating tasks from roadmap or milestone documents
Tracking any markdown planning or design content

Supported Documents

Any markdown file containing planning or design content:

Plan files from plan mode (~/.claude/plans/*.md)
Specification documents (SPEC.md, REQUIREMENTS.md)
Design documents (DESIGN.md, ARCHITECTURE.md)
Roadmaps and milestone documents (ROADMAP.md)
Feature proposals and technical RFCs

Usage

/dex-plan <markdown-file-path>

Examples

From plan mode:

/dex-plan /home/user/.claude/plans/moonlit-brewing-lynx.md

From specification document:

SKILL.md on GitHub

Details

Repository: github.com/dcramer/dex
Categories: Documentation, Productivity & Planning, Design & UI/UX
First seen: Jun 3, 2026