task-planner

Decompose feature designs into validated JSON task graphs and Markdown plan files.

1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/wyattjoh/skills --skill task-planner-wyattjoh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-planner
Source: https://github.com/wyattjoh/skills/tree/main/skills/task-planner
Command: npx skills add https://github.com/wyattjoh/skills --skill task-planner-wyattjoh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the ambiguity and lack of structure often found when breaking down complex software features, ensuring that designs are decomposed into clear, reviewable, and independently implementable tasks.

Core Features & Use Cases

  • Automated Decomposition: Converts high-level feature designs into a validated JSON task graph.
  • Dependency Management: Enforces strict DAG (Directed Acyclic Graph) validation to ensure tasks are ordered correctly based on code dependencies.
  • Standardized Scaffolding: Automatically generates consistent Markdown plan files for each task, including context, implementation details, and acceptance criteria.
  • Use Case: Use this after a design session to turn a complex feature requirement into a set of structured, ready-to-execute tasks for an agentic orchestrator.

Quick Start

Run the task-planner skill by providing a path to your design document or feature description to initiate the decomposition process.

Frequently Asked Questions about task-planner

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

FAQPage Schema
How do I decompose a complex feature design into actionable tasks?

To decompose a complex feature design, you can use automated scaffolding scripts that validate dependencies and generate standardized Markdown plan files. This transforms high-level designs into a JSON-based task graph with clear acceptance criteria for orchestrators.

What is a validated JSON task graph for software engineering workflows?

A validated JSON task graph is a structured representation of decomposed feature tasks that enforces strict Directed Acyclic Graph (DAG) dependencies. It ensures tasks are ordered correctly based on code dependencies to prevent execution cycles and structural conflicts.

Do I need Bun and commander to run task planning scaffolding scripts?

Yes, you need the Bun runtime and the commander package to execute the task planning scaffolding scripts. These dependencies are required to process feature design documents and validate the generated task graph integrity.

How does automated task decomposition handle code dependencies and seams?

Automated task decomposition handles code dependencies by applying a structured grilling pass on seams and acceptance criteria. It enforces strict DAG validation to ensure tasks are ordered correctly based on code dependencies before generating Markdown plan files.

Can I convert feature design documents into Markdown plan files automatically?

Yes, you can convert feature design documents into Markdown plan files automatically by running scaffolding scripts. This process generates consistent files for each task, including implementation details, context, and acceptance criteria.

What are the limitations of using a DAG task planner for feature decomposition?

A limitation of using a DAG task planner is that it requires strict dependency validation, meaning circular dependencies will fail the scaffolding process. Additionally, it requires a Bun runtime environment and the commander package to execute properly.