coreyhaines31/makerskills / skills/castmate
castmate
FlaggedWhen you want to pull in the right AI model for the right job: hand a task to another agent CLI (Codex, Claude, Gemini, Grok, Amp, OpenCode, Cursor, Kiro, Antigravity), or send one prompt to several at once for independent opinions, then synthesize. Delegate mode gives one castmate the job, optionally with write access ('have codex write the migration'). Fan-out mode runs read-only reviews in parallel. Rounds mode lets castmates build on and challenge each other's findings. Calls the official CLIs you already have installed and logged in (Gemini CLI needs an API key on personal accounts); no MCP. Triggers on '/castmate,' 'ask codex,' 'have gemini do this,' 'get a second opinion,' 'what would other models say,' 'fan this out,' 'cross-check this with another model,' 'delegate this to codex.' Advisor personas for founder questions go to maker-council. Personal models, casting rules, and run outputs live in ~/.config/makerskills/castmate/.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.7 KB |
| references/amp-readonly-settings.json | config | 229 B |
| references/casting.md | markdown | 2.6 KB |
| references/cli-setup.md | markdown | 11.3 KB |
| references/gemini-readonly-policy.toml | config | 857 B |
| references/presets/README.md | markdown | 757 B |
| references/presets/bughunt.md | markdown | 1.6 KB |
| references/presets/contracts.md | markdown | 1.1 KB |
| references/presets/hotspots.md | markdown | 1.7 KB |
| references/presets/invariants.md | markdown | 1.5 KB |
| references/presets/regression.md | markdown | 1.1 KB |
| references/presets/security.md | markdown | 1.5 KB |
| references/prompt-template.md | markdown | 3.1 KB |
| references/tools.json | config | 9.1 KB |
| scripts/castmate.pyexecutable | script | 21.1 KB |
| scripts/test_castmate.py | script | 11.7 KB |
references/casting.md
View on GitHub# Casting: which castmate for which job
These are default heuristics. The user's own rules in `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/castmate/casting.local.md` come first, because they are based on what the user has actually seen. Model strengths change with every release, so treat these defaults as a starting point to replace.
## Principles
1. **Diversity beats ranking for opinions.** A second opinion is worth most from a different model family than the one that wrote the work. If the host is Claude, cast a Codex or Gemini castmate first, and the reverse for other hosts.
2. **Match cost to stakes.** Use a fast tier (`haiku`, `codex-luna`, `gemini-flash`) for mechanical jobs: summarize a log, rename across files, draft boilerplate, answer a lookup. Use a top tier with high effort (`fable-high`, `codex-sol-high`) for architecture, security, or anything that is costly to get wrong.
3. **One writer, many readers.** Hand a write job to a single castmate. Fan out only read-only work.
4. **Prefer enforced read-only for reviews.** `castmate.py list` shows the read-only level for each castmate. A `best-effort` castmate can still edit files, so say so before you use it on a review.
5. **Unverified adapters fail loudly at first.** Run `castmate.py test <name>` once before relying on one.
## Starting defaults by job
| Job | Default cast | Why |
|---|---|---|
| Second opinion on a plan or diff | 1–2 castmates outside the host's model family, top tier | Independent blind spots |
| Broad bug or security hunt | `review` or `wide` group, 2–3 rounds with a preset | Each round builds on the last |
| Delegate a scoped coding task | One castmate with `--write`, top tier | One writer; the host reviews the diff. Prefer codex when the castmate must run tests itself; Claude's write mode edits files but has no shell |
| Mechanical, bulk, or cheap task | One fast-tier castmate | Saves the host's context and budget |
| Tie-breaker when the host and user disagree | One castmate that hasn't seen the argument, given only the facts | Unanchored read |
| Research a library or API | `codex-research`, or claude / gemini (web search on by default) | Reads current docs. Codex only searches live when cast as `codex-research` |
## Recording what works
When a castmate does notably well or badly on a kind of job, offer to append a line to `casting.local.md`:
```markdown
- Migrations in Rails apps → codex-sol-high (clean, ran the tests itself). 2026-11-03
- Long-doc summarizing → haiku is enough; fable was overkill. 2026-11-03
```
Keep each line dated. Prefer the newer line when two disagree.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |