CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

88

1.14x
Quality

81%

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

70%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, comprehensive skill for an inherently complex multi-phase workflow. Its greatest strength is workflow clarity — the phased approach with explicit decision points, validation steps, and feedback loops is excellent. The main weaknesses are moderate verbosity (some sections over-explain) and the length of the inline content, which could benefit from splitting Phase 5 and some reference material into separate files.

Suggestions

Consider moving Phase 5 (Scenario Quality Review) into a separate reference file since it's marked as 'Bonus' and adds significant length to the main skill.

Tighten the run label section — the concept is simple and Claude can compose descriptive labels; 2-3 examples would suffice instead of 6 plus the ingredient list.

DimensionReasoningScore

Conciseness

The skill is quite long (~300+ lines) and contains some verbosity, but most content is necessary given the complexity of the multi-phase workflow. Some sections like the bucket classification explanations and the 'Rules for good fixes' could be tightened. The run label section is thorough but slightly over-explained with many examples.

3 / 5

Actionability

Provides concrete CLI commands (tessl eval run, tessl eval view --last --json, jq queries, git commands), specific bucket classification thresholds (>=80%), and clear output templates. Minor gaps: some steps like 'Read the relevant plugin files' and 'Find the gap' are more procedural guidance than executable, and the diagnostic steps in Phase 2 are somewhat abstract.

4 / 5

Workflow Clarity

Excellent multi-phase workflow with clear sequencing (Phase 0 through 5), explicit validation checkpoints (lint after fixes in 3.3, re-run and verify in Phase 4), feedback loops (re-run → compare before/after → iterate on remaining gaps), and clear stopping criteria. Phase 0 handles multiple starting states with branching logic. The poll-for-completion and retry-on-failure steps are explicit.

5 / 5

Progressive Disclosure

The skill references companion skills (setup-skill-performance) and external reference files (phase3-fixtures-and-setup.md, phase5-view-results.md) which is good progressive disclosure design. However, no bundle files were provided, so we can't verify these references resolve. The SKILL.md itself is quite long and some content (like the detailed Phase 5 scenario quality review) could arguably be split into a separate reference file. The inline content is well-structured with clear headers but borders on monolithic.

3 / 5

Total

15

/

20

Passed

Description

92%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 a strong skill description that clearly articulates both what the skill does and when to use it. It provides comprehensive concrete actions and an explicit, detailed 'Use when...' clause with multiple natural trigger scenarios. The description is well-scoped to a distinct domain (task eval debugging and improvement) with minimal conflict risk.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: run task evals, analyze results, diagnose failures, apply targeted fixes, re-run to verify improvements. This is comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

Clearly answers both 'what' (run evals, analyze results, diagnose failures, apply fixes, re-run) and 'when' with an explicit 'Use when...' clause listing seven concrete trigger scenarios including debugging scores, fixing regressions, reviewing rubric quality, and improving agent performance.

5 / 5

Trigger Term Quality

Includes strong natural trigger terms like 'eval scores', 'failing criteria', 'regressed criteria', 'rubric quality', 'before/after score improvements', and 'agent performance'. Could benefit from mentioning specific file types or tool names, but covers most natural phrases a user would say.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around task evaluation debugging and improvement cycles. The specific terminology around eval criteria, rubric quality, score improvements, and plugin content editing makes it unlikely to conflict with general coding or testing skills.

5 / 5

Total

19

/

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.