Skills, scripts and the delegate CLI for orchestrating coding agents: plan, delegate, review and land tickets.
概览
Skills, helper scripts and the delegate CLI for coding agents (Claude Code, pi): planning a ticket, landing it through delegated lanes, reviewing and repairing PRs, triaging CI, and running a flywheel of tickets with the owner away. Started from mattpocock/skills and reworked since. Clone to ~/.agents and link the skills into your agent's skills folder, for example: The skills call scripts at ~/.agents/bin/. Delegated work runs through the delegate CLI in delegate/, a Rust binary that runs tasks on Cursor, pi and Claude Code models. Install it with ~/.agents/delegate/bin/setup.sh; see delegate/README.md. It moved here from aakshintala/delegate, which is archived and keeps the old issue and PR history. Branch, open a PR, squash merge. CI (ci) runs test/run and delegate's format, lint and tests, and must pass on a head up to date with main.
README
以下为原文 README 节选，完整内容请查看原文。
switchyard
Skills, helper scripts and the delegate CLI for coding agents (Claude Code, pi): planning a ticket, landing it through delegated lanes, reviewing and repairing PRs, triaging CI, and running a flywheel of tickets with the owner away.
Started from mattpocock/skills and reworked since.
Layout
| Path | What it holds |
|---|---|
skills/ |
One folder per skill: SKILL.md, plus brief templates in briefs/ where the skill starts other jobs. |
delegate/ |
The delegate CLI (Rust): runs a brief on another model and reports a job record. |
bin/ |
Scripts the skills call: fill-brief, plan-check (check a plan’s paths against its base), plan-sweep (one read-once context pack: symbol sites, outlines, doc sections and the paths outside a plan’s Files), plan-gate (a plan’s gate command, from its ## Gate heading), review-pr, gh-ci, pr-closes, ship-pr, check-pack, agent-cost (token and cache cost of recent agents, by kind), ci-health (hourly fiber CI health check), ci-friction (same test failing across CI lanes), inbox-send (deliver a stdin message to a file inbox, atomically, or over ssh when INBOX_HOST is set), inbox-wait (block until an inbox file waits and print its path), inbox-drain (print every unread inbox message and move each to read/), post-ruling (post a ruling comment, copy it to the run dir, fix the label and drop an inbox line in one call). |
claude-code/agents/ |
Claude Code agent definitions: ticket-orchestrator (a flywheel lane, run as its own claude --bg session) and claude-worker (a Claude lane, Verifier or fix job). |
test/ |
Tests for the scripts. test/run runs every suite. |
docs/agents/ |
This repo’s own setup for the skills: issue tracker, triage labels, workflow doc. |
Install
Clone to ~/.agents and link the skills into your agent’s skills folder, for example:
git clone https://github.com/aakshintala/switchyard ~/.agents
for s in ~/.agents/skills/*/; do ln -s "$s" ~/.claude/skills/; done
for a in ~/.agents/claude-code/agents/*.md; do ln -s "$a" ~/.claude/agents/; done # Claude Code only
The skills call scripts at ~/.agents/bin/.
delegate
Delegated work runs through the delegate CLI in delegate/, a Rust binary that runs tasks on Cursor, pi and Claude Code models. Install it with ~/.agents/delegate/bin/setup.sh; see delegate/README.md. It moved here from aakshintala/delegate, which is archived and keeps the old issue and PR history.
Working on it
Branch, open a PR, squash merge. CI (ci) runs test/run and delegate’s format, lint and tests, and must pass on a head up to date with main.
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add aakshintala/switchyard