dex-plan

Convert Markdown planning documents into Dex tasks with subtasks.

375|20|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/dcramer/dex --skill dex-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dex-plan
Source: https://github.com/dcramer/dex/tree/main/plugins/dex/skills/dex-plan
Command: npx skills add https://github.com/dcramer/dex --skill dex-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts Markdown planning documents into actionable dex tasks by automating the creation of a parent task from planning content and ensuring traceable context for downstream work.

Core Features & Use Cases

  • Convert planning docs (plans, specs, roadmaps) into a Dex parent task with full context.
  • Analyze plan structure to determine subtasks and automatically create them linked to the parent.
  • Preserve provenance by attaching plan sections, identifiers, and references for later traceability.

Quick Start

Use the /dex-plan command to convert a Markdown planning document into a Dex task:

  • /dex-plan /home/user/plans/auth-plan.md
  • After creation, inspect with: dex show <task-id>

Frequently Asked Questions about dex-plan

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

FAQPage Schema
How do I convert markdown planning documents into trackable tasks?

To convert markdown planning documents into trackable tasks, you can use the dex-plan workflow to parse the file content and automatically generate a parent task with linked subtasks. It analyzes the plan structure to determine the appropriate subtask breakdown.

How does automated subtask creation from markdown plans work?

Automated subtask creation works by analyzing the markdown plan content to determine if a breakdown is needed, then generating context-rich subtasks that are directly linked to the parent task for full traceability.

Can I preserve provenance and context when creating tasks from markdown specs?

Yes, you can preserve provenance and context when creating tasks from markdown specs. The workflow attaches plan sections, identifiers, and references directly to the generated tasks for later traceability.

Do I need external services to automate task management from markdown files?

No, you do not need external services to automate task management from markdown files. The workflow relies entirely on standard Dex CLI commands and requires only the Dex runtime environment to function.

What is the best way to break down a markdown roadmap into parent and subtasks?

The best way to break down a markdown roadmap into parent and subtasks is using an automated workflow that reads the document, creates a parent task with full context, and analyzes the structure to generate linked subtasks.