| name | models |
| description | Show or change which model each frugal agent runs on, per project. Use when the user wants to see the current tier-to-model mapping, move an agent to a different model (e.g. scout to sonnet), or reset overrides. Triggers on "frugal models", "change router models", "which model does scout use". |
| disable-model-invocation | true |
Frugal model overrides
Manage the per-project model mapping for frugal's agents. Defaults live in each
agent's frontmatter (agents/*.md under the plugin root); overrides live in the
project's .claude/routing-overrides.md, which the routing policy reads first.
Overrides work because the Agent tool accepts a model parameter per spawn - no
plugin files are ever edited.
Valid agents: scout, extractor, mechanic, builder, sage.
Valid models: haiku, sonnet, opus, fable.
No arguments: show the mapping
- Read each agent's default from the
model: frontmatter line in
<plugin-root>/agents/*.md (plugin root is two directories up from this
skill's base directory).
- Read the "Model overrides" section of
.claude/routing-overrides.md if it
exists.
- Show one table: agent, default, override (or "-"), effective model. Nothing
else.
Arguments like scout=sonnet builder=opus
-
Validate every pair against the lists above. Invalid agent or model: reject
with the valid options, change nothing.
-
Create or update the managed section in .claude/routing-overrides.md
(create the file if missing, keep any unmanaged content above it intact):
## Model overrides (managed by /frugal:models)
| Agent | Model |
|---|---|
| scout | sonnet |
When spawning a frugal agent listed above, pass its listed model as the
Agent tool's `model` parameter.
-
Merge with existing overrides: new pairs win, unmentioned pairs stay.
-
Setting an agent to its default removes its row. Empty table: remove the
whole section.
-
Confirm with the resulting mapping table and apply it immediately to any
spawns later in this session.
Argument reset
Remove the managed section. If the file is then empty, delete the file.
Show the default mapping.
