setup
Phase 0 of the prd-taskmaster pipeline. Resolves the active backend, initializes the project, configures the provider stack when the TaskMaster backend is active (DETECT-FIRST — never overwrite a working user config), and verifies the AI pipeline.
Install / Use
npx skills add anombyte93/prd-taskmaster --skill setupInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of setup
setup scores 86/100 on our quality scale, 1841st of 2,769 Automation skills we index.
Its SKILL.md is 7.4 KB long, well organised into 12 sections with 7 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.
setup compared with similar skills
All 4 of these similar skills score higher than setup; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| setup (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 setup?
- Run
npx skills add anombyte93/prd-taskmaster --skill setup. The install tabs above show the steps for each supported agent. - Which AI agents does setup 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 setup 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 setup 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: setup description: >- Phase 0 of the prd-taskmaster pipeline. Resolves the active backend, initializes the project, configures the provider stack when the TaskMaster backend is active (DETECT-FIRST — never overwrite a working user config), and verifies the AI pipeline. Autonomous: zero user questions unless a hard block is hit. Declares the Setup phase complete so DISCOVER can follow. user-invocable: false allowed-tools:
- Read
- Bash
- Skill
- ToolSearch
- mcp__atlas-engine
- mcp__plugin_prd_go
- mcp__plugin_prd-taskmaster_go
- mcp__plugin_atlas-go_go
Phase 0: Setup
Declarative phase skill. Invoked by the prd-taskmaster orchestrator when
current_phase is null or SETUP. Never called directly by a user.
Entry gate
-
Call
mcp__plugin_prd_go__check_gate(phase="SETUP", evidence={})for diagnostics.check_gateis an EXIT gate: it verifies you have the evidence to advance, not to enter. On first entry you have no evidence yet (Step 4 below producesvalidate_setup.ready=true), so agate_passed: falseresult here is EXPECTED — the state machine's legal transitions (None → SETUP) already guarantee only legal entry.- First entry (no evidence yet): note the result and continue with the Procedure.
- Re-entry: if the gate reports violations, report them and stop — it protects against re-running a completed phase or skipping ahead.
Enforce the gate when you ADVANCE (after the procedure), not on entry.
Procedure (5 steps, abort on hard failure)
Step 1: Backend detection
Run backend detection:
python3 script.py backend-detect
The native engine is the sole generator and needs no external binary — a
keyless host CLI (claude / codex / gemini) on PATH, or a provider API key,
is sufficient (see Chunk 7's atlas setup wizard). The task-master binary is
no longer required or supported; backend-detect reports its presence purely as
informational. Continue with the resolved (native) backend.
Step 2: Project init
Check whether the current project has a .taskmaster/ directory (the engine
still reads/writes the .taskmaster/ file format for tasks and config).
If missing, run backend op init:
python3 script.py init-project
This initialises the native project state and the .taskmaster/ file format. If
.taskmaster/ is present, continue.
Step 2.5: Customisation bootstrap (REQUIRED — closes execute-task deadlock)
execute-task requires .atlas-ai/customizations/system-prompt-template.md
to exist as a precondition (its Entry gate halts otherwise). It cannot
create the file from inside the loop — the failure mode is a hard halt with
no recovery path.
This step ensures the file exists BEFORE execute-task ever runs:
PLUGIN_SKEL="${CLAUDE_PLUGIN_ROOT}/skel/customizations"
mkdir -p .atlas-ai/customizations
if [ ! -f .atlas-ai/customizations/system-prompt-template.md ]; then
if [ -d "$PLUGIN_SKEL" ]; then
cp -n "$PLUGIN_SKEL"/*.md .atlas-ai/customizations/ # -n: no-clobber, copy starter pack
else
: > .atlas-ai/customizations/system-prompt-template.md # empty is fine per execute-task Entry gate
fi
fi
The starter pack (domain-vocabulary.md, system-prompt-template.md,
task-enrichment-rules.md, verification-preferences.md) is editable —
users tune them to project-specific terminology. Empty is acceptable; the
file simply must exist.
Also scaffold .atlas-ai/ship-check.py if it doesn't already exist:
if [ ! -f .atlas-ai/ship-check.py ] && [ -f "${CLAUDE_PLUGIN_ROOT}/skel/ship-check.py" ]; then
cp "${CLAUDE_PLUGIN_ROOT}/skel/ship-check.py" .atlas-ai/ship-check.py
chmod +x .atlas-ai/ship-check.py
fi
(Codified 2026-06-04 — yesterday's run halted at execute-task Entry
because system-prompt-template.md was missing; the file had to be
manually touch-ed from outside the loop.)
Step 3: Provider configuration — DETECT-FIRST
When the TaskMaster backend is active, read task-master models output BEFORE
setting anything. This is the load-bearing rule. A working user config must
NOT be overwritten silently. When the native backend is active, provider
configuration is handled by the resolved backend and this TaskMaster-specific
step is informational only.
| task-master models output | Action |
|---|---|
| Main / Research / Fallback all populated with a supported provider | SKIP — go to Step 4. |
| Main set, Research/Fallback empty | Partial mutate — fill the empty roles only. |
| All three empty (fresh install) | Full configure — use the default stack below. |
| Provider flagged unsupported / deprecated | Ask the user before mutating. |
Why DETECT-FIRST: v4 dogfood (2026-04-13, LEARNING #9) caught the skill
overwriting a working gemini-cli / gemini-3-pro-preview config because the
procedure wasn't branch-aware. Detect first, mutate only the empty slots.
Default stack (fresh install only):
task-master models --set-main gemini-3-pro-preview --gemini-cli
task-master models --set-research gemini-3-pro-preview --gemini-cli
task-master models --set-fallback gemini-3-flash-preview --gemini-cli
Why Gemini CLI: ~113× more token-efficient than sonnet on parse-prd, free via any Google account, no API key. One provider, three roles, zero cost.
Alternatives: Claude Max (--claude-code sonnet/opus/haiku), any of the
12 task-master provider families, or a registered MCP research tool for the
Research role.
Step 4: Probe test
If tasks already exist, call the MCP tool
mcp__plugin_prd_go__validate_setup or run backend op rate:
python3 script.py rate
If no tasks exist yet (fresh project), skip the probe — Step 3's provider configuration is sufficient evidence the pipeline is wired.
Step 5: Status line
Render the preflight progress panel and print it. MCP-mode: call
render_status(phase="SETUP") and print its rendered field. CLI-mode:
python3 script.py status --phase SETUP. (Fallback if the renderer is
unavailable — emit a compact one-block status:)
Setup:
task-master: installed (<version>)
project: initialized (.taskmaster/)
provider: <main-provider> (main) / <research-provider> (research)
pipeline: verified
Exit gate
After Steps 1–5 report green:
- Call
mcp__plugin_prd_go__advance_phase(expected_current="SETUP", target="DISCOVER", evidence={"validate_setup": <Step 4 result dict>, "provider_configured": True}). The call atomically transitionspipeline.jsonfrom SETUP to DISCOVER. Theexpected_currentfield is the compare-and-swap guard;evidenceis stored underphase_evidence[DISCOVER]for audit. - Return control to the orchestrator (
prd-taskmasterskill). Do NOT invoke DISCOVER directly — the orchestrator re-readscurrent_phaseand routes.
Red flags (stop and report, do not paper over)
- "The config is set but looks wrong — I'll fix it" → NO. Report and ask.
- "No tasks exist so I'll skip backend detection" → NO. Backend detection must run before DISCOVER so later backend ops resolve consistently.
- "I'll auto-install task-master via npm" → NO. Installation is a user action; this skill only reports that installation unlocks the TaskMaster backend.
- "I can call advance_phase without check_gate" → NO. Gate first, always.
Non-exits
This skill does not use explicit process termination. A hard block reports the reason and returns control to the orchestrator; the orchestrator decides whether to surface to the user.
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.
