Optimizes AI skills for activation, clarity, and cross-model reliability. Use when creating or editing skill packs, diagnosing weak skill uptake, reducing regressions, tuning instruction salience, improving examples, shrinking context cost, or setting benchmark/release gates for skills. Trigger terms: skill optimization, activation gap, benchmark skill, with/without skill delta, regression, context budget, prompt salience.
Install
npx skills add https://github.com/mcollina/skills --skill skill-optimizerSKILL.md
When to use
Use this skill when you need to:
- Improve whether a skill is actually applied by models
- Diagnose why some criteria fail across all models
- Prevent a skill from making outputs worse
- Refactor skill text for stronger retrieval under context pressure
- Build repeatable benchmark loops and release gates
Optimization loop (default workflow)
- Measure baseline and skill-on behavior (per model, per scenario, per criterion)
- Find failure pattern:
- universal failure (0% with skill)
- model-specific weakness
- regression (negative delta)
- Edit for salience:
- add explicit triggers
- add concrete integrated examples
- tighten checklists and decision rules
- Re-run evals and compare deltas
- Ship with guardrails (documented gate + run history + follow-up issues)
How to use
Read individual rule files for detailed procedures and templates:
- rules/benchmark-loop.md - End-to-end benchmark loop and scoring
- rules/activation-design.md - Improve retrieval and instruction uptake
- rules/context-budget.md - Reduce token cost without losing behavior
- rules/regression-triage.md - Diagnose and fix skill-on regressions
- rules/release-gates.md - Go/no-go criteria before shipping skill updates
Practical heuristics
- Prefer few high-signal rules over many soft recommendations
- Put fragile, high-value behaviors in top-level checklists
- Include at least one integrated example per common scenario
- Add explicit wording for what must not be omitted
- Track gains/losses with with-skill vs without-skill comparisons
Related skills
find-skillsvercel-labs3.6MHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.handoffmattpocock883KCompact the current conversation into a handoff document for another agent to pick up.microsoft-foundrymicrosoft618KBuild, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent create, create agent, update agent, add tool to agent, invoke agent, agent.yaml, agent insights, pull agent insights, evaluate agent, batch eval, continuous eval, continuous monitoring, agent CI/CD, optimize prompt, improve prompt, prompt optimizer, optimize agcavemanjuliusbrussee544KUltra-compressed communication mode that cuts output tokens while keeping technical accuracy. Levels: lite, full, ultra and the wenyan variants. Use for /caveman, "caveman mode", "talk like caveman", "be brief" or "less tokens".