Updated today
by invergent-ai
surogates
Open platform for running Managed Agents at scale
28 GitHub stars (28)
+1 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | 0 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | 0 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | 0 |
| Oct 10 | 0 |
| Oct 11 | +1 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 21 skills (21 skills found in its SKILL.md files)
- 1 forks (1 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add invergent-ai/surogates
Asks which skills and agents to install. Just one: npx skills add invergent-ai/surogates --skill subagent-task-orchestrator — add -g for every project.
Claude Code
git clone https://github.com/invergent-ai/surogatescp -r "surogates/skills/kanban/subagent-task-orchestrator" ~/.claude/skills/
Copies the subagent-task-orchestrator skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add invergent-ai/surogates
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
subagent-task-orchestrator
Decomposition playbook and anti-temptation rules for an orchestrator agent that routes work through the Surogates subagent task layer. Pair this skill with an AgentDef whose tool filter strips the implementation tools (terminal, file, web, code) — that's how 'don't do the work yourself' is enforced structurally, not just behaviorally.
skills/kanban/subagent-task-orchestrator/SKILL.md on GitHub (opens in a new tab) -
subagent-task-worker
Pitfalls, examples, and edge cases for workers executing a Surogates subagent task. Loaded automatically when the dispatcher spawns a session bound to a Task (Session.task_id is set).
skills/kanban/subagent-task-worker/SKILL.md on GitHub (opens in a new tab) -
brainstorming
You MUST use this before any creative work — creating features, building components, drafting documents, designing workflows, or modifying behavior. Explores your human partner's intent, requirements, and design before any implementation begins.
skills/process/brainstorming/SKILL.md on GitHub (opens in a new tab) -
dispatching-parallel-agents
Use when facing 2+ independent tasks or investigations that can be worked on without shared state or sequential dependencies — fan out to specialized sub-agents with isolated context, then synthesize the results.
skills/process/dispatching-parallel-agents/SKILL.md on GitHub (opens in a new tab) -
executing-plans
Use when you have a written implementation plan to execute inline in the current session with review checkpoints. Prefer subagent-driven-development when sub-agent dispatch is available.
skills/process/executing-plans/SKILL.md on GitHub (opens in a new tab) -
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code or producing output. Turns a design into bite-sized, copy-pasteable tasks with exact paths and complete code.
skills/process/writing-plans/SKILL.md on GitHub (opens in a new tab) -
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment. Applies Test-Driven Development to process documentation — watch agents fail without the skill, write the skill that addresses those failures, then close loopholes.
skills/process/writing-skills/SKILL.md on GitHub (opens in a new tab) -
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or…
skills/productivity/doc-coauthoring/SKILL.md on GitHub (opens in a new tab) -
docx
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing image…
skills/productivity/docx/SKILL.md on GitHub (opens in a new tab) -
maps
Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.
skills/productivity/maps/SKILL.md on GitHub (opens in a new tab) -
nano-pdf
Edit PDF text/typos/titles via nano-pdf CLI (NL prompts).
skills/productivity/nano-pdf/SKILL.md on GitHub (opens in a new tab) -
ocr-and-documents
OCR for scanned/image-only PDFs and complex documents (pymupdf, marker-pdf). For text-based PDFs use read_file.
skills/productivity/ocr-and-documents/SKILL.md on GitHub (opens in a new tab) -
pdf
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file o…
skills/productivity/pdf/SKILL.md on GitHub (opens in a new tab) -
pptx
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working…
skills/productivity/pptx/SKILL.md on GitHub (opens in a new tab) -
xlsx
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especia…
skills/productivity/xlsx/SKILL.md on GitHub (opens in a new tab) -
arbor-coordinator
The Arbor research-coordinator protocol: the OBSERVE -> IDEATE -> SELECT -> DISPATCH -> DECIDE cycle over a durable Idea Tree. Preloaded automatically on /auto-research sessions. The coordinator never edits code or runs commands — executors do that in isolated worktrees; the coordinator steers the tree with idea_tree / dispatch_experiments / merge_experiment.
skills/research/arbor-coordinator/SKILL.md on GitHub (opens in a new tab) -
arbor-executor
The Arbor executor workflow: clone the repo from the git bundle your brief hands you, implement and evaluate exactly ONE hypothesis with the file tools, then report structured results via worker_complete. Preloaded automatically on arbor-executor task workers. Never touch the held-out test split.
skills/research/arbor-executor/SKILL.md on GitHub (opens in a new tab) -
arbor-ideate
Hard-gated ideation for an Arbor research run. Load at the START of every IDEATE round, before drafting any hypothesis. Enforces the PI mindset (mechanism over knob), the four-question first-principles probe, the kill-filter, and the four-line hypothesis format. Ported from Arbor's idea_drafting + first_principles_probe.
skills/research/arbor-ideate/SKILL.md on GitHub (opens in a new tab) -
arbor-merge-discipline
DECIDE-phase doctrine for an Arbor research run: when to merge, prune, combine, or finalize; how the held-out merge gate works; and the rule that the final report uses TEST scores. Load before deciding what to do with completed experiments.
skills/research/arbor-merge-discipline/SKILL.md on GitHub (opens in a new tab) -
arbor-research
Intake for an autonomous research run (Arbor). Use when the user wants to optimize a metric in a repo over many isolated experiments — 'optimize this benchmark', 'improve the model F1 overnight', 'beat the leaderboard'. Discovers the repo/eval/splits, measures the baseline, confirms a Research Contract, then emits a ready-to-send /auto-research command. Does NOT start the run itself.
skills/research/arbor-research/SKILL.md on GitHub (opens in a new tab) -
shadcn
Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".
web/.agents/skills/shadcn/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.