task-generator_skill

Overview

This skill generates structured, actionable task lists from specs, plans, or requirements. It produces a two-phase task file with high-level parent tasks first, then detailed sub-tasks, file mappings, and test guidance tailored for a junior developer. After exiting spec mode, it will always ask the user if they want a task list generated.

How this skill works

The skill analyzes the spec to extract feature name, scope, and functional requirements, then creates /tasks/tasks-[feature-name].md. Phase 1 produces 5–7 high-level parent tasks (always starting with 0.0 Create feature branch unless opted out) and asks the user to confirm continuation. On receiving "Go" it enters Phase 2 and breaks each parent task into focused sub-tasks, identifies files and test files to create or modify, and updates the task file with checkable items.

When to use it

• When you have a spec, plan, PRD, or requirements document and need an implementation checklist
• Before assigning work to junior developers to ensure clear, granular tasks
• When you want a repo-ready task file that includes test file suggestions
• When you want consistent branch and file naming derived from spec title
• When you need to convert a high-level plan into step-by-step actionable work

Best practices

• Provide a clear spec title so the feature name can be derived in kebab-case
• Confirm whether to include the default "Create feature branch" task before generation if you prefer to opt out
• Keep each sub-task completable in one focused session (small, single-purpose steps)
• Include file paths or examples in the spec to improve file mapping accuracy
• Reply "Go" to proceed from parent tasks to sub-task generation

Example use cases

• Convert a product PRD into a runnable task list with files and tests identified
• Turn a design doc into implementation steps for a junior engineer
• Generate a checklist from a bug-fix spec including test cases and files to update
• Create onboarding work for a new contributor from a feature plan
• Produce a task file to attach to a ticket or project board