SkillAgentSearch skills...

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-tasks

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Category

Marketing

Supported Platforms

Universal

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.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
12/20
Freshness
11/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
expand-tasks (this skill)by anombyte93866033mo agoSKILL.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.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.

name: 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.json must exist (run /prd:go first)
  • 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.json that Claude Code can call directly (for example mcp__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:

  1. Write agent output to a temp file:

    cat > /tmp/research-task-<ID>.md <<'EOF'
    <agent output>
    EOF
    
  2. Write research back to tasks.json:

    python3 skills/expand-tasks/script.py write-research --task-id <ID> --research /tmp/research-task-<ID>.md
    
  3. 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:

  1. Agent receives task context (title, description, dependencies, subtasks)
  2. Agent runs 3-5 targeted queries against the user's configured research provider. The research-expander agent is tool-agnostic: it picks up whichever research tools are available in the current Claude Code session. This may be task-master research, an MCP search/reason tool from ~/.claude.json (including any mcp__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.
  3. Agent distills results into structured summary
  4. 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_notes field of each task in tasks.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-expander agent typically completes in ~30s depending on research backend and query depth; 15 tasks ≈ 3 waves ≈ 2-3 minutes total

Related Skills

View on GitHub
GitHub Stars603
CategoryMarketing
Updated3mo ago
Forks58

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions