tasks

Extract a structured task list from plan.md into tasks.md with user-story mapping.

1|Updated May 28, 2026
One-click install
npx skills add https://github.com/amoutiers/maxi-superpowers --skill tasks-amoutiers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tasks
Source: https://github.com/amoutiers/maxi-superpowers/tree/main/skills/tasks
Command: npx skills add https://github.com/amoutiers/maxi-superpowers --skill tasks-amoutiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan-driven teams often struggle to convert plan.md content into actionable tasks. This Skill extracts a structured tasks.md from an existing plan.md, preserving user-story mapping and the required phase checkpoints.

Core Features & Use Cases

  • Structured extraction: Convert plan.md items into numbered tasks with US labels and phase checkpoints.
  • Traceability: Maintain links between tasks and user stories (e.g., US1, US2) and prerequisites (constitution.md, spec status).
  • Template-driven output: Produce docs/maxi/specs/NNNN-slug/tasks.md following the tasks-template.md structure.

Quick Start

Run the /maxi:tasks skill to transform plan.md into a fully structured tasks document at docs/maxi/specs/NNNN-slug/tasks.md.

Frequently Asked Questions about tasks

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

FAQPage Schema
How do I convert a plan.md file into actionable user story tasks?

User story traceability is maintained by mapping each extracted task to explicit user story labels such as US1 or US2. The generated tasks.md document preserves these links alongside phase checkpoints to ensure every task connects back to its original plan.md requirement.

How do I generate a phase-structured tasks document from an existing plan?

Generating a tasks.md document requires the spec.md status to be planned and depends on prerequisites like constitution.md. The process checks these entry barriers before operating, ensuring the plan.md content is validated and ready for structured task extraction.

Does task extraction from plan.md require a specific spec status?

Yes, task extraction from plan.md operates only when the spec.md status is set to planned. This prerequisite ensures the plan has been validated and prevents generating tasks.md documents from unapproved or incomplete plans.

What is the best way to enforce phase checkpoints when creating a tasks list?

The best way to enforce phase checkpoints is by using a template-driven extraction that applies a strict phase template to the tasks.md output. This guarantees sequential IDs and explicit dependencies are formatted correctly for reproducible planning.

Why does task generation fail when spec.md is not in a planned state?

Task generation fails when spec.md is not planned because the tool enforces traceability prerequisites and validates the spec status before processing plan.md. This constraint prevents creating disconnected tasks from unapproved planning phases.