expand-tasks
Expand all TaskMaster tasks with deep research before coding begins. Reads tasks.json, launches parallel research agents per task in waves using the research-expander agent. Writes findings back to tasks.json. Part of the prd-taskmaster toolkit. Use after PRD is parsed and before implementation.
Install / Use
npx skills add anombyte93/prd-taskmaster --skill expand-tasksInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Our assessment of expand-tasks
expand-tasks scores 86/100 on our quality scale, 416th of 646 Marketing skills we index.
Its SKILL.md is 7.8 KB long, well organised into 15 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
It has 603 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
expand-tasks compared with similar skills
All 4 of these similar skills score higher than expand-tasks; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| expand-tasks (this skill)by anombyte93 | 86 | 603 | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install expand-tasks?
- Run
npx skills add anombyte93/prd-taskmaster --skill expand-tasks. The install tabs above show the steps for each supported agent. - Which AI agents does expand-tasks work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is expand-tasks safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is expand-tasks still maintained?
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: expand-tasks description: >- Expand all TaskMaster tasks with deep research before coding begins. Reads tasks.json, launches parallel research agents per task in waves using the research-expander agent. Writes findings back to tasks.json. Part of the prd-taskmaster toolkit. Use after PRD is parsed and before implementation. Invoke with /expand-tasks. user-invocable: true allowed-tools:
- Read
- Write
- Edit
- Bash
- Task
- Skill
- Glob
- Grep
- AskUserQuestion
- ToolSearch
- mcp__atlas-engine
- mcp__plugin_prd_go
- mcp__plugin_prd-taskmaster_go
- mcp__plugin_atlas-go_go
Expand Tasks with Research v1.0
Expands TaskMaster tasks with research before coding begins.
Deterministic operations handled by script.py; AI handles judgment.
Script location: skills/expand-tasks/script.py (relative to plugin root)
Part of: prd-taskmaster plugin
Depends on: research-expander agent (parallel research worker), any research
provider configured via task-master models --set-research or registered as an
MCP research tool.
When to Use
Activate when user says: expand tasks, research tasks, research before coding for all, expand subtasks. Do NOT activate for: single task research (use /research-before-coding), PRD generation (use /prd:go).
Native-parallel first (token economy)
Before launching agent waves, check the cheaper path: the native engine expands tasks
in parallel for free. Prefer python3 script.py expand — backend op expand (native api) —
or the expand_tasks MCP tool: it runs structured expand across pending tasks
concurrently (inheriting the engine's ThreadPoolExecutor) on economy-tier models /
keyless host CLIs and merges atomically.
Use THIS skill's agent waves when: no provider/CLI is available, native expand reports
failures for specific tasks (rerun just those here), or the research must be repo-grounded
(agents can read the codebase; native expand cannot).
Prerequisites
- TaskMaster
tasks.jsonmust exist (run/prd:gofirst) - A research provider is configured — either (a)
task-master models --set-research <model> --<provider>for any task-master provider family, or (b) an MCP research tool registered in~/.claude.jsonthat Claude Code can call directly (for examplemcp__plugin_prd_go__*tools or an external search/reason MCP) - At least 1 task in
tasks.json
Workflow (5 Steps)
Step 1: Preflight
python3 skills/expand-tasks/script.py read-tasks
Returns JSON: total, expanded, pending_expansion, tasks[].
If pending_expansion is 0: Report all tasks already expanded. Exit skill.
If research provider is not configured: Check via task-master models and verify a research role is set. If none, tell the user to configure one (task-master models --set-research <model> --<provider>) and exit. The skill does not assume any specific research backend — it uses whatever is configured.
Step 2: Choose Scope
Use AskUserQuestion:
- All tasks (default): Expand every task that hasn't been researched yet
- Specific tasks: User provides task IDs (comma-separated)
- By dependency level: Expand tasks with no dependencies first, then next wave
AI judgment: Recommend "All tasks" for initial expansion, "By dependency level" for incremental work.
Step 3: Generate Research Prompts
For each task to expand:
python3 skills/expand-tasks/script.py gen-prompt --task-id <ID>
Returns JSON with prompt field containing the full research agent prompt.
AI judgment: Review the auto-generated prompt. Customize research questions if the task needs domain-specific queries. Add project context from the PRD or session-context files if relevant.
Step 4: Launch Parallel Research Agents
Launch research agents in parallel waves. Each wave = up to 5 concurrent agents.
For each task, spawn a Task agent using the dedicated research-expander
subagent type (defined in agents/research-expander.md):
Task(
subagent_type: "research-expander",
description: "Research Task <ID>: <title>",
run_in_background: true,
prompt: <prompt from Step 3>
)
Wave strategy:
- Wave 1: Tasks with no dependencies (they inform downstream tasks) — run in parallel
- Wave 2: Tasks depending on Wave 1 — run in parallel
- Wave 3+: Continue until all tasks covered — run in parallel per wave
- Max 5 agents per wave to avoid overwhelming the configured research backend
Wait for each wave to complete before launching the next. Parallel dispatch only happens WITHIN a wave; waves themselves are serial.
Step 5: Collect and Write Results
As each research-expander agent completes, save its research output:
-
Write agent output to a temp file:
cat > /tmp/research-task-<ID>.md <<'EOF' <agent output> EOF -
Write research back to
tasks.json:python3 skills/expand-tasks/script.py write-research --task-id <ID> --research /tmp/research-task-<ID>.md -
After all tasks are written, verify:
python3 skills/expand-tasks/script.py status
AI judgment: Review each research result for quality. If a result is too thin (< 5 lines of useful content) or clearly failed, re-run that specific task's research through a fresh research-expander invocation.
Research Agent Prompt Pattern
The gen-prompt command generates prompts that follow the
research-before-coding pattern:
- Agent receives task context (title, description, dependencies, subtasks)
- Agent runs 3-5 targeted queries against the user's configured research provider. The
research-expanderagent is tool-agnostic: it picks up whichever research tools are available in the current Claude Code session. This may betask-master research, an MCP search/reason tool from~/.claude.json(including anymcp__plugin_prd_go__*tools registered by this plugin), WebSearch as a last resort, or whatever the user has bound. The skill does not hard-code any specific research MCP. - Agent distills results into structured summary
- Summary returns to main context (~25-40 lines per task)
Critical: prefer structured research tools (task-master research, MCP
search/reason tools) over raw WebSearch/WebFetch when available — they produce
cleaner outputs with citations.
Error Handling
| Error | Action |
|-------|--------|
| Research provider unreachable or rate-limited | Exit skill, tell user to verify task-master models research role is set and reachable |
| research-expander agent returns empty/failed | Re-run that specific task with different queries |
| tasks.json not found | Exit skill, tell user to run /prd:go first |
| Task already expanded | Skip silently unless user forces re-expansion |
| Agent timeout | Mark task as failed, continue with others |
Output
After all tasks are expanded, the skill reports:
- Total tasks expanded
- Any failures that need retry
- Next recommended action (usually: begin implementation)
Integration with prd-taskmaster
This skill fits between Step 8 (Parse & Expand Tasks) and Step 11 (Choose Next Action) of the prd-taskmaster workflow. After PRD is parsed into tasks but before execution begins.
/prd:go → generates PRD → parses into tasks
↓
/expand-tasks → research-expander agents run in Parallel waves → writes findings back to tasks.json
↓
Implementation begins (with research context in each task)
Tips
- Run after PRD generation but before any implementation
- Research results are stored in
research_notesfield of each task intasks.json - Re-running on already-expanded tasks is safe (will skip unless forced)
- For very large task lists (20+), consider expanding in dependency order to save context
- Each
research-expanderagent typically completes in ~30s depending on research backend and query depth; 15 tasks ≈ 3 waves ≈ 2-3 minutes total
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
