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 and release gates for skills. Trigger terms: skill optimization, activation gap, benchmark skill, with/without skill delta, regression, context budget, prompt salience.
87
87%
Does it follow best practices?
Impact
87%
1.14xAverage score across 5 eval scenarios
Passed
No known issues
{
"context": "Tests whether the agent applies activation-design patterns when rewriting a poorly-structured skill: adding explicit triggers near the top, front-loading non-negotiables in a numbered checklist with imperative wording, replacing fuzzy phrasing with strict phrasing, and adding a realistic integrated example — while avoiding activation anti-patterns.",
"type": "weighted_checklist",
"checklist": [
{
"name": "Explicit triggers at top",
"description": "SKILL-improved.md includes a trigger list near the top (within the first 30 lines) containing at least 2 concrete domain-specific signals (e.g. schema changes, rollback, Alembic, Flyway, backward-compat, migration, lock)",
"max_score": 10
},
{
"name": "Numbered top-level checklist",
"description": "SKILL-improved.md contains a numbered checklist (1. 2. 3. ...) at or near the top of the document body that lists non-negotiable behaviors",
"max_score": 10
},
{
"name": "Imperative wording in checklist",
"description": "The top-level checklist uses imperative phrasing: at least one item uses 'Use', 'Include', 'Do not', or 'Must' rather than 'consider', 'may want', or 'should'",
"max_score": 10
},
{
"name": "Fuzzy phrasing removed",
"description": "SKILL-improved.md does NOT contain any of: 'consider using', 'you may want', 'it's generally a good idea', 'sometimes that's not always needed', 'might want to'",
"max_score": 10
},
{
"name": "Strict phrasing for mandatory rules",
"description": "Rules that were soft in the original (rollback section, safety checks) are now stated with 'must', 'use', 'do not omit', or 'required' in SKILL-improved.md",
"max_score": 10
},
{
"name": "Integrated example — realistic input",
"description": "SKILL-improved.md contains an example that goes beyond a single ALTER TABLE line and represents a realistic migration scenario (e.g. multi-step migration, data migration, or includes rollback section)",
"max_score": 10
},
{
"name": "Integrated example — shows output format",
"description": "The example in SKILL-improved.md shows the final expected output format (e.g. a complete migration file with rollback block, not just a snippet)",
"max_score": 10
},
{
"name": "Non-negotiables front-loaded",
"description": "The rollback requirement and backward-compatibility check appear in the top half of SKILL-improved.md, not buried after deployment instructions or other secondary content",
"max_score": 10
},
{
"name": "No split core behavior",
"description": "SKILL-improved.md does NOT split the rollback or safety rules into separate files without a clear link from the top of the document (anti-pattern: splitting one core behavior across too many documents without navigation)",
"max_score": 10
},
{
"name": "Explicit omission warning",
"description": "SKILL-improved.md contains explicit language about what must NOT be omitted (e.g. 'Do not omit the rollback section' or 'Never skip the backward-compatibility check')",
"max_score": 10
}
]
}