guydemo/skill-review-optimizer
Iteratively review and optimize Tessl skills using `tessl skill review` — validates frontmatter, checks description specificity and trigger terms, evaluates content conciseness, actionability, and workflow clarity, then applies automated optimizations and re-reviews until quality targets are met. Use when the user wants to evaluate, improve, or optimize skills in their project — e.g. "review my skills", "optimize my skills", "improve skill quality", "run tessl review", or "make my skills better". Also use when the user wants to demonstrate the value of Tessl skill review.
100
Quality
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Discovery
100%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 excels across all dimensions. It provides specific concrete actions, includes natural trigger terms users would actually say, explicitly addresses both what and when, and has a clear distinctive niche around Tessl skill review functionality.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'validates frontmatter', 'checks description specificity and trigger terms', 'evaluates content conciseness, actionability, and workflow clarity', 'applies automated optimizations and re-reviews'. Uses third person voice correctly. | 3 / 3 |
Completeness | Clearly answers both what (iteratively review and optimize skills using specific validation checks) AND when (explicit 'Use when...' clause with multiple trigger scenarios and example phrases). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'review my skills', 'optimize my skills', 'improve skill quality', 'run tessl review', 'make my skills better'. These are realistic user phrases. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche: Tessl skill review/optimization. The tool name 'tessl skill review' and focus on skill quality metrics make it highly distinct and unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%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-crafted skill that demonstrates excellent conciseness, actionability, and workflow clarity. The iterative optimization loop with explicit stop conditions and the reference to external output format documentation shows thoughtful progressive disclosure. The skill provides exactly what Claude needs to execute the task without unnecessary explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing only necessary information without explaining concepts Claude already knows. Every section serves a clear purpose with no padding or unnecessary context. | 3 / 3 |
Actionability | Provides fully executable bash commands with clear placeholders, specific stop conditions with percentages, and concrete iteration logic. The workflow is copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear 4-step sequence with explicit sub-steps in the optimize loop. Includes validation checkpoints (baseline review, re-review) and well-defined stop conditions that create a feedback loop for error recovery. | 3 / 3 |
Progressive Disclosure | Appropriately structured with a concise overview and one-level-deep reference to output format in a separate file. Content is well-organized without being monolithic. | 3 / 3 |
Total | 12 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Install with Tessl CLI
npx tessl i guydemo/skill-review-optimizerReviewed
Table of Contents