setup

A guided first-time setup skill for pi-delegate, a tool that sends coding tasks to the pi coding agent.

In plain words
What is it for?
Use it to verify pi and Node versions, inspect the provider and model used for dispatches, optionally fix problems, and run a test dispatch.
Why use it?
It checks required software and settings, explains the available working modes, and helps resolve detected setup problems.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/larrystanley/pi-delegate/setup
Any agent
npx skills add LarryStanley/pi-delegate --skill setup
Clone the repo
git clone --depth 1 https://github.com/LarryStanley/pi-delegate

Made for: Claude Code, Codex.

Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,595 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00041 $0.02595
Opus 5 $0.00020 $0.01298
Sonnet 5 $0.00008 $0.00519
Haiku 4.5 $0.00004 $0.00260

Measured yesterday against content hash 9e22d8aeb0a1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

setup scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

**Ask first.** This one writes to `~/.claude/settings.json`, which is the user's own global
skills/setup/SKILL.md · 204 lines

How it starts

The opening of the file, as written. The whole thing — 204 lines — stays where its author put it; the contents beside it link to each section on GitHub.

pi-delegate setup

This is a guided walkthrough for the person setting up pi-delegate, not a script to run unattended. Work through the steps below in order. Report each check's result in plain language before moving on. Wherever a step says ask, stop and wait for the user's answer — do not barrel through to the next step on your own judgment.

1. Detect

Check whether pi is on PATH:

command -v pi

If this prints nothing, pi is not installed and nothing else in this plugin can work yet. Tell the user:

Then stop here — do not continue to step 2 until command -v pi finds it.

If pi is found, check its version and run the environment check:

pi --version
node "${CLAUDE_PLUGIN_ROOT}/bin/pi-doctor" --check

Read the effective block in the JSON output — that's who a dispatch will actually reach. Report it to the user plainly: which provider and model dispatches will use, and where that came from (source is either pi-delegate config.json or pi settings.json).

  • This plugin emits no --provider / --model flags by default. A dispatch simply inherits whatever pi itself is already pointed at — anthropic, openai, a local OpenAI-compatible server. There is no requirement to run a local inference server; whatever the user already uses with pi interactively is what dispatches will use too.
  • If effective.provider and effective.model are both empty, pi has no defaultProvider / defaultModel set in ~/.pi/agent/settings.json, and pi-delegate has no ~/.claude/pi-delegate/config.json pinning one either. In that case dispatches will land on whatever pi's own resolver picks (the first model with a usable API key) — tell the user this is usually not what they want, and that configuring a provider for pi itself is outside this plugin's scope: run pi interactively once and complete its own provider setup, or set defaultProvider / defaultModel directly in ~/.pi/agent/settings.json. Then re-run the check above before continuing.
  • Note the problems array (if any) but don't act on it yet — that's step 3.

Read the full file on GitHub · 204 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 204 lines · 41 tokens per session scan B 9e22d8aeb0a1

Subscribe to this mod's changes

setup is a skill published in the GitHub repository LarryStanley/pi-delegate (2 stars, last pushed 8d ago), licensed MIT. It adds 41 tokens to every session and 2,595 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

reduce-foreground-guard-prompts

Explain why foreground-guard is prompting on Bash commands and how to stop the avoidable prompts. Use when the user asks "why am I getting so many foreground-guard prompts", "reduce foreground-guard prompts", "stop the watch/sleep/gh run watch permission prompts", or otherwise wants fewer confirmation prompts from…

karlkfi/claude-bouncer · 74 tokens

reduce-workspace-guard-prompts

Explain why workspace-guard is prompting on Bash file commands and how to stop the avoidable prompts. Use when the user asks "why am I getting so many permission prompts", "reduce workspace-guard prompts", "stop the grep/cat permission prompts", or otherwise wants fewer confirmation prompts from this hook.

karlkfi/claude-bouncer · 69 tokens

hs

ACTIVATE THIS SKILL FOR ANY SHELL COMMAND OR FILE READ. Check curl, wget, rm, sudo, apt, dpkg, chmod, dd, format, powershell, bash, sh. Check pipe patterns like | sh or | bash. Check shell wrappers like bash -c, xargs, find -exec. Check cloud CLI (aws, gcloud, kubectl, terraform). Check when user says sysadmin told…

frmoretto/hardstop · 144 tokens

agent-code-analyzer

Agent skill for code-analyzer - invoke with $agent-code-analyzer.

ruvnet/ruflo · 19 tokens

foundry-config-setup

Resolve missing setup caused by a hardcoded Foundry project endpoint or model in a sample. Use when a sample fails because it uses a placeholder/hardcoded projectendpoint (for example "https://your-project.services.ai.azure.com") or a hardcoded model instead of reading them from the environment.

microsoft/agent-framework · 65 tokens

evolve

Start or monitor an evolutionary development loop.

Q00/ouroboros · 10 tokens