CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

optimize-skill-performance

Run task evals, analyze results, diagnose failures, apply targeted fixes, and re-run to verify improvements. Use when debugging evaluation scores, fixing failing or regressed criteria, analyzing why eval criteria pass or fail, reviewing eval rubric quality and redundant criteria, tracking before/after score improvements, editing plugin content to fix specific failing behaviors, or improving agent performance based on eval evidence.

1.14x
Quality

93%

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

85%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.

The body is a highly actionable, well-sequenced improvement workflow with excellent validation loops — actionability and workflow clarity are top-tier. Its weaknesses are a ~380-line monolithic structure with a dangling reference (phase5-view-results.md) and minor commentary that could be trimmed for token efficiency.

Suggestions

Fix the dangling references: give "phase5-view-results.md" a full resolvable path (e.g. ../setup-skill-performance/references/phase5-view-results.md) or inline the §5.1b procedures it points to.

Move the run-label catalogue (ingredients + six examples) and Phase 0.4's detailed analysis procedures into a references/ file, keeping SKILL.md as a lean overview with one-level-deep pointers.

Trim evaluative commentary in the bucket definitions (e.g. "These are your plugin's strengths. Leave them alone.") and shorten the illustrative output tables to the essential rows to reduce token cost.

DimensionReasoningScore

Conciseness

The body is dense and operational, but includes minor commentary that could be trimmed ("These are your plugin's strengths. Leave them alone.", "This is where fixes have the highest impact.") and long illustrative output blocks that pad the token budget — matching the 'efficient; minor instances of over-explanation' anchor rather than the lean 'every token earns its place' level.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready commands ("tessl eval run <path/to/plugin> --label <run-label>", the jq filter for skipForcedContextActivation), exact decision thresholds (">= 80% of max"), verbatim user-facing prompts, and worked before/after examples covering the common cases — matching the top anchor; it is not the 'minor gaps' level.

5 / 5

Workflow Clarity

The multi-phase workflow (Phase 0 through 5) is explicitly sequenced with validation checkpoints at every risky step: lint after each fix (3.3), poll for completion with retry on failure (4.4), before/after verification (4.5), and explicit stopping criteria — matching the anchor with feedback loops and checkpoints; edits are user-approved and validated, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

References exist but are not clearly signaled or resolvable: "phase5-view-results.md" is cited three times (Phase 0.4) with no path and does not exist in this bundle, and the ~380-line monolith inlines material (run-label catalogue, Phase 0.4 analysis procedures) that belongs in reference files — matching the 'references present but not clearly signaled' anchor rather than the well-organized level 4.

3 / 5

Total

17

/

20

Passed

Description

100%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.

The description is exemplary: third-person imperative voice, a complete five-action capability statement, and an explicit 'Use when' clause rich in natural trigger synonyms. It clearly satisfies every top anchor with no over-claiming or padding.

DimensionReasoningScore

Specificity

Lists five concrete actions covering the entire improvement cycle ("Run task evals, analyze results, diagnose failures, apply targeted fixes, and re-run to verify improvements"), which matches the comprehensive-coverage anchor; no part of the workflow is left out, so it is not the level below.

5 / 5

Completeness

Explicitly answers both questions: a clear what (the five-action cycle) and an explicit "Use when..." clause with concrete trigger phrases, exactly matching the top anchor; the 'when' is not weakly implied, so it is not a 4.

5 / 5

Trigger Term Quality

Covers natural user phrasings with synonyms — "debugging evaluation scores", "eval criteria pass or fail", "failing or regressed criteria", "before/after score improvements", "improving agent performance based on eval evidence" — matching the comprehensive synonym-coverage anchor rather than the 'a few natural terms missing' level.

5 / 5

Distinctiveness Conflict Risk

All triggers are anchored to evals, scores, and criteria (even "improving agent performance" is qualified with "based on eval evidence"), giving a clear niche with minimal conflict risk; the broadest phrase is still eval-specific, so it is not the mostly-distinct level.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

tesslio/product-plugins

Path

skill-optimizer/skills/optimize-skill-performance/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.