Pilotfish — AI skill for Claude Code
Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality.
How to install Pilotfish
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open Nanako0129/pilotfish and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Pilotfish does
Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality. One-prompt install.
Alternatives in AI
- Fusion Plan — OMC interview (interactive) → 3-round Opus 4.8 + GPT-5.5 fusion deepening → concise .omc/plans/ output → revie 468 ★
- Vibe Coding Toolkit — A curated, battle-tested AI-coding toolkit: Claude Code plugins, subagent orchestration, quality gates, and re 297 ★
- Learn Skills.Dev — Curated high-quality AI Agent Skills 203 ★
README
pilotfish 🐟
Small, fast role agents handle volume work while the frontier main session keeps planning, approval, integration, and final judgment.
**pilotfish** is a multi-model orchestration policy for [Claude Code](https://code.claude.com). The [macOS and Linux Plugin beta](./install/PLUGIN-INSTALL.md) adds hook-based ambient activation; the global configuration install remains a legacy alternative. The policy uses the `opus` family for the main session, Sonnet and Haiku for bounded execution and reconnaissance, and fresh Opus contexts for risk-triggered review.
[繁體中文](./README.zh-TW.md)
Contents
Why
Most coding-session tokens are spent on search, repetitive edits, tests, and documentation rather than frontier judgment. pilotfish routes those bounded paths to cheaper roles while keeping the main session accountable and using fresh-context reviewers at material acceptance boundaries.
New installs default to the `opus` alias; Fable remains an explicit `/model fable` choice. This is a cost-aware default, not a claim that one model wins every task. The rationale and measurements live in [research](./docs/research.md), the [design notes](./docs/design.md), and [#23](https://github.com/Nanako0129/pilotfish/issues/23).
| Host or use case | Project |
|---|---|
| Claude Code global policy | This repository |
| Claude Code with session-scoped GPT routing | remora |
| Grok Build | pilotfish-grok |
| Codex CLI | pilotfish-codex |
How it works
The Plugin beta packages the policy and namespaced roles under Claude Code's native Plugin lifecycle. The legacy global install uses these direct targets:
| Layer | Installed target | Responsibility |
|---|---|---|
| Machine | `~/ |
Related Skills
Pilotfish Grok
Grok Build–native multi-model orchestration, inspired by pilotfish. Frontier main session plans; role agents e
Vector OS Nano
Vector OS is an agent orchestration system built around models: it plans tasks, routes commands to the right m
Agentic Engineers
portable sub-agent orchestration "AGENTS with SKILLS" (Orchestrator delegates 1..N specialist AGENTS (model+sk
Efficient Fable Orchestrator
Claude Code skill: turns a session into a quota-conscious orchestrator that plans at a high level and delegate
Cheap LLM Router
Save Claude/Codex subscription tokens by routing context-only file reads through a cheaper LLM (DeepSeek, Kimi
Nectra
One chat for every AI model you have. Nectra routes each message to the best-fit model across Claude Code, Cod
Related Agents
10x
10x is a terminal-based CLI coding agent (installed via npm install -g 10x-cli) built around the observation t
Vision
GSD-2 is the orchestration layer between you and AI coding agents. It handles planning, execution, verificatio
DB Schema Architect
Use when designing or modifying database schemas, migrations, multi-tenant data models, or polymorphic table s