| name | skill-tuner |
| description | Optimize RealDeal CPA for the LLM in use. When the partner switches models (or asks to 'tune/optimize for <model>', 'I'm using a smaller/local model', 'make it work better on X'), match the model to a tier and apply the right reasoning effort, autonomy budget, and skill style — config-only by default, with an optional deep re-tune of the skill text. Fully reversible. |
| version | 1.0.0 |
| author | RealDeal CPA |
| license | MIT |
| platforms | ["linux","macos","windows"] |
| metadata | {"hermes":{"tags":["Optimization","Models","Tuning","Reasoning-Effort","Skills","Config"],"related_skills":["self-improvement"]}} |
Skill Tuner — optimize for the chosen LLM
Different models need different handling. A frontier reasoner does best with lean,
principle-first skills and long autonomy; a small or local model needs explicit
micro-steps, tighter loops, and lower reasoning effort. This skill offers that as an
option — it never changes anything until asked.
When to use
- The partner switched the model (
vragent.ps1 model) or said which model they're running.
- They ask to "optimize/tune for ", "I'm on a smaller/local model", or "why is it slow/over-thinking".
The tool
scripts/optimize-skills.ps1 reads vr-overlay/config/model-profiles.yaml, matches the
active model to a tier (frontier / strong / mid / small), and applies that tier's
settings. Run it from the repo root.
| Invocation | Effect |
|---|
.\scripts\optimize-skills.ps1 | Offer only — prints the active model, its tier, and the exact changes it would make. No change. |
.\scripts\optimize-skills.ps1 -Model <name> | Offer for a specific model (e.g. before you switch). |
.\scripts\optimize-skills.ps1 -Apply | Apply the config tuning: set model.default, agent.reasoning_effort, agent.max_turns for the tier, then re-sync. |
.\scripts\optimize-skills.ps1 -Apply -Deep | Also fan out a re-tune of the skill text to the tier's style (lean / scaffolded / explicit). Writes reversible overrides to home/skills/ (delete them to revert). |
.\scripts\optimize-skills.ps1 -Revert | Remove any deep-tune overrides and restore the canonical skills. |
What each tier changes (config)
- reasoning_effort — high for frontier/strong, medium for mid, low for small.
- max_turns — longer autonomy for stronger models, tighter loops for smaller ones.
- skill_style (deep mode) — lean / scaffolded / explicit guidance density.
How to run it as the agent
- Get the active model: read
model.default in the config (or what the partner names).
- Run the offer first (no
-Apply) and show the partner what it would change.
- If they approve, run with
-Apply (add -Deep only if they want the skill text re-tuned
for a notably weaker/smaller model).
- Confirm with
vragent.ps1 doctor and a quick skills list.
Guardrails
- Default is offer-only; never apply tuning without the partner's go-ahead or an explicit
-Apply.
- The deep re-tune writes overrides, never touching the tracked canonical skills —
-Revert undoes it.
- Tuning changes how skills are delivered, never the authority gates or the accounting correctness.
