CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

optimize-skill-performance-and-instructions

Run the full optimization cycle for a plugin — review best practices, generate eval scenarios, run BOTH activation evals (does the skill self-activate?) and content evals (does the plugin help solve tasks?), diagnose gaps, fix, and re-run until scores improve. Use when someone says "optimize my skill", "improve my plugin", "run evals", "benchmark my plugin", or wants to measure and improve how well a plugin helps agents solve tasks.

1.14x
Quality

92%

Does it follow best practices?

Impact

89%

1.14x

Average score across 29 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is tessl/skill-optimizer

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary orchestrator skill: concrete commands, thresholds, and decision gates make it fully executable, and the step structure with entry/exit criteria and stop conditions is airtight. The only improvement is trimming the repeated activation-vs-content explanations across sections.

DimensionReasoningScore

Conciseness

The body is dense and operational with no explanation of concepts Claude already knows, but the activation-vs-content-eval distinction is restated four times (Overview, Step 2, Step 5, "When to stop") and the stop-gate condition repeats across Step 2 and "When to stop" — minor over-explanation that could be trimmed, matching the 4 anchor rather than the lean 5.

4 / 5

Actionability

Guidance is fully executable: exact commands with flags ("tessl eval run <plugin-path> --skip-forced-context-activation --skip-scoring --label <run-label>"), a copy-paste skill-count command, explicit numeric thresholds (≥85% stop gate, ≥80% baseline triage, 2-iteration cap), and a complete report template covering fired/not-fired and cross-reference cases.

5 / 5

Workflow Clarity

Five clearly sequenced steps each carry entry/exit criteria or decision points, an explicit eval-ordering rule by skill count, feedback loops (re-run evals, compare before/after), an iteration cap, and a dedicated "When to stop" section — explicit validation checkpoints throughout, matching the 5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist, and the skill is a clean orchestrator: all detail is appropriately delegated to three clearly-signaled sub-skills invoked per step, with well-organized section headers and easy navigation — matching the clear-overview / appropriately-split 5 anchor.

5 / 5

Total

19

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it comprehensively enumerates the cycle's concrete actions in third person and pairs them with an explicit, naturally-phrased trigger clause. The only gaps are a few missing trigger synonyms and minor overlap with its own sub-skills' territory.

DimensionReasoningScore

Specificity

The description lists six concrete actions spanning the entire cycle — "review best practices, generate eval scenarios, run BOTH activation evals … and content evals …, diagnose gaps, fix, and re-run until scores improve" — matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Both questions are explicitly answered: a clear "what" (the full cycle of concrete actions) and an explicit "when" ("Use when someone says 'optimize my skill'…"), matching the 5 anchor exactly rather than the 4 anchor where the "when" could be more explicit.

5 / 5

Trigger Term Quality

It quotes natural phrases users would actually say ("optimize my skill", "improve my plugin", "run evals", "benchmark my plugin") plus "wants to measure and improve", but misses common synonyms such as "evaluate", "test", or "score my plugin" — good coverage with a few natural terms missing, so 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (plugin eval/optimization) with distinct triggers, but phrases like "improve my plugin" and "run evals" overlap with its own closely related sub-skills (optimize-skill-instructions, setup-skill-performance) that a user might want individually — minor overlap risk with closely related skills, the 4 anchor rather than minimal-conflict 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tesslio/product-plugins

Path

skill-optimizer/skills/optimize-skill-performance-and-instructions/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.