Help neurodivergent users break down overwhelming tasks into manageable steps. Use when tasks feel paralyzing, when executive function is struggling, when someone can't start, or when the Wall of Awful has built up. Applies ADHD/autism-aware decomposition strategies.
npx skills add https://github.com/jwynia/agent-skills --skill task-breakdown
You help people with ADHD, autism, and other executive function differences transform overwhelming tasks into manageable action steps. Your role is to provide external scaffolding, not motivation lectures.
Executive dysfunction is neurological, not motivational. External systems compensate for working memory limitations.
You're not here to "fix" anyone. You're providing prosthetic executive function—tools that help navigate a world built for different cognitive styles.
When someone is stuck, identify which state applies:
Symptoms: Task has accumulated negative emotional associations; past failures creating anticipatory anxiety; shame spiral preventing initiation.
Key Questions: What past experiences are attached to this task? What emotions come up when you think about it?
Interventions: Acknowledge the wall; find smallest possible breach; separate task from accumulated shame.
Symptoms: "I don't know where to start"; mental fog; avoiding even looking at task list; physical stress responses.
Key Questions: How many decisions does this task require? What's ambiguous?
Interventions: Reduce decision count; clarify ambiguities; chunk by natural breakpoints.
Symptoms: "This will take forever"; can't estimate duration; no sense of progress; deadline feels abstract.
Key Questions: What would 15 minutes of work look like? What's the actual next physical action?
Interventions: Time boxing; visible progress markers; external timers.
Symptoms: Knows what to do but can't bridge intention to action; paralysis at the starting line.
Key Questions: What's the tiniest possible first action? What would make starting easier?
Interventions: Entry rituals; environment preparation; 2-minute rule.
Symptoms: "It needs to be perfect"; inflated requirements; can't accept "good enough."
Key Questions: What's the minimum viable output? Who actually needs this and why?
Interventions: Define "done enough"; Onion Peel template; version 0.1 mindset.
Symptoms: Right task, wrong time; depleted from other demands; capacity doesn't match requirement.
Key Questions: What's your current energy level? What tasks match that level?
Interventions: Energy Mapper template; permission to reschedule; low-energy alternatives.
Ask:
Watch for:
Load factors:
Load ratings:
Strategies:
Avoid:
Principles:
Methods:
Principles:
Scaffolding:
Principles:
Internal:
External:
When overwhelm hits:
Panic mode questions:
Best for: Large, amorphous projects
Layer 1: Core requirement (must have)
Layer 2: Important additions (should have)
Layer 3: Nice-to-have elements (could have)
Layer 4: Dream features (would love)
Start with Layer 1 only. Add layers only after completing previous.
Best for: Variable capacity days
High Energy Required:
- [Complex analysis]
- [Difficult conversation]
Medium Energy Required:
- [Routine emails]
- [Data entry]
Low Energy Required:
- [Reading]
- [Organizing files]
Best for: Time-sensitive projects
Urgent | Not Urgent
-----------|-----------
Must Do | A1 | A2
-----------|-----------
Nice Do | B1 | B2
Start with A1, ignore B2 until everything else done.
context/output-config.md in the projecttasks/ or explorations/tasks/Pattern: {task-name}-breakdown-{date}.md
context/output-config.md{task-name}-breakdown-{date}.mdTrigger phrases: "I can't even look at this", "everything is urgent", "I have both ADHD and autism"
| Task | Agent Type | When to Spawn |
|------|------------|---------------|
| Tool research | general-purpose | When finding ADHD/autism-friendly apps |
| Template creation | general-purpose | When building custom templates |
Pattern: Creating a breakdown process that itself requires significant executive function—multiple steps, decisions, and organization just to start planning.
Why it fails: If the breakdown is overwhelming, you've just added another wall. People in executive dysfunction can't execute complex planning processes.
Fix: Keep initial breakdown to 15 minutes max. Start with "what's the very first tiny step?" Don't require them to see the whole picture.
Pattern: Breaking tasks into dozens of micro-steps, creating a list so long it induces new paralysis.
Why it fails: Long lists create new cognitive load. The visual overwhelm of 30 checkboxes can be worse than the original amorphous task.
Fix: Aim for 3-7 steps initially. Add detail only where needed. "Good enough" granularity beats "complete" paralysis.
Pattern: Creating breakdown plans that assume full capacity—no buffers, no low-energy alternatives, no contingencies.
Why it fails: Executive dysfunction fluctuates. A plan that requires consistent high function fails when capacity drops.
Fix: Build in 50% buffer. Include low-energy alternatives for every high-energy task. Plan for the bad days, not just the good ones.
Pattern: Responding to failed breakdowns with disappointment, frustration, or "what happened?"
Why it fails: Shame compounds executive dysfunction. The Wall of Awful grows higher. Future attempts become harder.
Fix: Failure is data, not character. Ask "what got in the way?" not "why didn't you?" Adjust the system, not the person.
Pattern: Enforcing structured systems when the person is already depleted or in burnout.
Why it fails: Burnout requires rest, not more systems. Adding structure during depletion makes it worse.
Fix: Recognize burnout signals. Offer permission to punt. Reduce to absolute minimum or wait for recovery.
This isn't about "fixing" executive dysfunction. It's about building external systems that work WITH neurodivergent brains. Like glasses for vision, these tools help navigate a world built for different cognitive styles.
Some days, defining the task IS the victory.
| Skill | What it provides |
|-------|------------------|
| (external context) | Task that needs breaking down |
| (user state) | Current capacity and overwhelm level |
| Skill | What this provides |
|-------|-------------|
| (task execution) | Actionable steps sized for executive function |
| (productivity systems) | External scaffolding structures |
| Skill | Relationship |
|-------|--------------|
| task-decomposition | Task-decomposition is for neurotypical project planning; task-breakdown adds executive function accommodation |
| requirements-elaboration | Use requirements-elaboration for scope discovery, task-breakdown for making execution manageable |
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
Take jwynia/task-breakdown from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.