CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

89

1.14x
Quality

86%

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

73%Scale 1-5

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

This is a well-structured orchestration skill that clearly sequences a complex multi-step optimization cycle with good decision points, thresholds, and stopping conditions. Its main strengths are workflow clarity and the thoughtful separation of activation vs content evals. The primary weakness is moderate verbosity — the run label section, report template, and some explanatory text could be tightened without losing clarity.

Suggestions

Trim the run labels section to 2-3 examples max and a one-line format description — Claude can compose descriptive labels without 6 examples.

Consider moving the detailed report template to a separate reference file (e.g., REPORT_TEMPLATE.md) to reduce the main skill's length while keeping it accessible.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient for an orchestration skill covering a multi-step optimization cycle, but includes some unnecessary verbosity — e.g., the run label section with 6 examples is longer than needed, the 'Two distinct eval types' explanation could be tighter, and the detailed report template is quite long. Some of this is justified by the complexity, but there's room to trim.

3 / 5

Actionability

Provides concrete CLI commands, clear decision logic (multi-skill vs single-skill ordering, baseline thresholds), and specific parameters (--count=5, >= 85%). However, it delegates heavily to sub-skills (optimize-skill-instructions, setup-skill-performance, optimize-skill-performance) without showing their exact invocation syntax, and some steps like 'Apply targeted, minimal fixes' remain somewhat abstract.

4 / 5

Workflow Clarity

The workflow is clearly sequenced across 5 steps with explicit entry/exit criteria, decision points (eval ordering by skill count, threshold-based stop conditions), iteration limits (max 2 improve iterations), and clear stopping conditions. The cross-referencing between activation and content evals in the report template shows thoughtful validation. Feedback loops are present in the optimize cycle (analyze → fix → re-run → compare).

5 / 5

Progressive Disclosure

The skill appropriately delegates detailed work to three sub-skills (optimize-skill-instructions, setup-skill-performance, optimize-skill-performance) and references them clearly. The overview diagram showing the relationship is helpful. However, no bundle files are provided, so we can't verify the sub-skill references resolve correctly, and the report template could potentially be in a separate file to reduce the main file's length.

4 / 5

Total

16

/

20

Passed

Description

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

This is an excellent skill description that comprehensively covers what the skill does (full optimization cycle with specific steps), when to use it (explicit trigger phrases), and occupies a clear niche (plugin/skill eval and optimization). The description is well-structured, uses third person voice, and provides enough detail for accurate skill selection without being unnecessarily verbose.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: review best practices, generate eval scenarios, run activation evals, run content evals, diagnose gaps, fix, and re-run until scores improve. Comprehensive coverage of the optimization cycle.

5 / 5

Completeness

Clearly answers 'what' (run the full optimization cycle including review, eval generation, running both eval types, diagnosing, fixing, re-running) and 'when' (explicit 'Use when...' clause with concrete trigger phrases like 'optimize my skill', 'run evals', 'benchmark my plugin').

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say: 'optimize my skill', 'improve my plugin', 'run evals', 'benchmark my plugin'. Also includes domain terms like 'activation evals', 'content evals', 'plugin', 'skill', and 'agents solve tasks' covering multiple natural phrasings.

5 / 5

Distinctiveness Conflict Risk

Highly distinctive niche — plugin/skill optimization with eval cycles. The combination of activation evals, content evals, and iterative improvement creates a clear, unique identity unlikely to conflict with other skills.

5 / 5

Total

20

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tesslio/product-plugins
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.