CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

improvement-workflow

Complete continuous improvement cycle orchestrating review, analysis, learning extraction, systematic updates, and validation. Sequential workflow from comprehensive review through pattern analysis and learning extraction to improvement application and re-validation. Use when continuously improving skills, applying review findings, implementing systematic enhancements, or executing complete improvement cycles.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/improvement-workflow/SKILL.md

The canonical home for this skill is improvement-workflow in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-sequenced orchestration workflow with explicit validation and iteration decision rules, but it is held back by triple-restating the same six-step pipeline and by delegating all executable detail to component skills without showing how to run them. Tightening the redundant sections and adding one concrete invocation example per step would raise both conciseness and actionability.

Suggestions

Remove one of the three restatements of the pipeline (the Quick Reference table or the ASCII diagram) and drop the generic 'Typical Improvements' and Practice/Rationale padding to cut roughly a third of the body.

Add one concrete executable line per step, e.g. the actual command or invocation used to run review-multi in comprehensive mode, instead of 'Use skill-updater workflow' alone.

Expand Step 4's 'Test each change' into an explicit checkpoint with a failure/recovery path (what to do when a change breaks the skill) to close the workflow validation gap.

DimensionReasoningScore

Conciseness

The body is mostly structured and free of concept explanations Claude already knows, but the six-step sequence is restated three times (detailed steps, the Quick Reference table, and the ASCII 'Workflow Pattern' diagram), and sections like 'Typical Improvements', the Practice/Rationale pairs, and the closing bold tagline restate obvious or already-covered points. This fits anchor 3 (mostly efficient, could be tightened) rather than 2, since no section explains background knowledge and each restatement has at least marginal navigational value.

3 / 5

Actionability

Guidance is moderately concrete: steps name specific component skills and operations ('Run review-multi comprehensive mode (all 5 operations)', 'Use analysis Operation 5 (Pattern Recognition)', 'Use best-practices-learner Operations 1-2') and give a numeric decision threshold ('≥0.5 points'). But nothing shows how to actually invoke these skills, what 'comprehensive mode' means operationally, or how to 'Test each change' — the executable detail is entirely delegated to absent external skills, matching anchor 3 (some concrete guidance but incomplete, missing key details).

3 / 5

Workflow Clarity

The six steps are clearly sequenced with purposes, and Step 5 provides explicit validation ('Run skill-validator', 'Re-run review-multi (compare before/after scores)') plus a post-workflow decision block with revert-on-regression instructions — a genuine feedback loop. This lands at anchor 4 rather than 5 because validation inside Step 4 is only the bare instruction 'Test each change' with no checkpoint or recovery procedure, a minor validation gap.

4 / 5

Progressive Disclosure

The skill has no bundle files, so this scores the single-file structure: sections are well-organized (Overview, When to Use, per-step detail, Best Practices, Quick Reference) with component-skill references named at one level of depth. This matches anchor 4 (good structure, content mostly appropriately placed, minor organization gaps) rather than 5 because the per-step Process/Outputs blocks and Best Practices could live in a reference file, and component skills like 'review-multi' are named without paths or links that would make navigation concrete.

4 / 5

Total

14

/

20

Passed

Description

78%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 with an explicit third-person 'what' plus a four-phrase 'Use when' trigger clause, giving excellent completeness and decent trigger coverage. Its weaknesses are abstract, buzzword-tinged action names and a redundant second sentence that restates the workflow without adding information.

Suggestions

Replace the redundant second sentence with concrete sub-actions, e.g. 'Runs comprehensive review, analyzes finding patterns, extracts learnings, applies updates one at a time, and re-validates before/after scores.'

Add missing natural trigger variants such as 'update a skill after review', 'apply review recommendations', or 'iterate on skill improvements'.

Sharpen abstract terms like 'orchestrating' and 'systematic enhancements' into specific operations (score comparison, backup, revert on regression) to lift specificity.

DimensionReasoningScore

Specificity

The description names the domain (skill improvement) and lists several action stages ('orchestrating review, analysis, learning extraction, systematic updates, and validation'), but these are abstract orchestration stages rather than concrete executable actions like 'extract text' or 'fill forms' in the anchor examples. It sits between anchor 3 (domain plus 1-2 concrete actions) and anchor 4 (several specific actions with minor gaps): more than two actions are named, yet none are concretely executable, and the second sentence merely restates the first ('Sequential workflow from comprehensive review through pattern analysis and learning extraction to improvement application and re-validation'), padding rather than adding specificity.

3 / 5

Completeness

Both what and when are explicitly present: the what is a clear enumeration ('Complete continuous improvement cycle orchestrating review, analysis, learning extraction, systematic updates, and validation') and the when is an explicit 'Use when' clause with four concrete trigger phrases, matching the anchor 5 example structure. Not 4 because the 'when' is not merely present but lists multiple specific triggers; the what, while abstract in wording, is fully and redundantly stated.

5 / 5

Trigger Term Quality

The 'Use when' clause provides good natural phrases users would say: 'continuously improving skills', 'applying review findings', 'implementing systematic enhancements', 'executing complete improvement cycles'. It falls at anchor 4 (good coverage, a few natural terms missing) rather than 5 because common variants like 'update a skill', 'validate a skill', 'apply review recommendations', or 'iterate on a skill' are absent, though for a meta-skill there are no file extensions to include.

4 / 5

Distinctiveness Conflict Risk

The niche (a full end-to-end improvement cycle for skills) is mostly distinct, but within its own ecosystem it overlaps with its component skills — triggers like 'applying review findings' could plausibly fire the review-multi or skill-updater skills alone. This matches anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than 5, since no phrasing like 'complete cycle' or 'end-to-end' requirement distinguishes it in every trigger.

4 / 5

Total

16

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/improvement-workflow/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.