CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

extract

Turn a proven pattern or debugging solution into a standalone reusable skill with SKILL.md, reference docs, and examples. Use when the user runs /si:extract or asks to package a recurring solution from memory into a skill.

68

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a well-sequenced, highly actionable workflow with explicit quality gates and concrete naming rules, templates, and worked examples, all at good token efficiency. The main improvement opportunities are specifying the skill-extractor agent's prompt (the core generation step is underspecified), moving the inline SKILL.md template to a reference file, and adding an explicit fix-and-recheck loop for failed quality gates.

Suggestions

In Step 4, include the prompt/spec to pass to the 'skill-extractor' agent (or note the fallback if the agent is unavailable), since the core file-generation step currently has no executable detail.

Move the ~40-line SKILL.md template from Step 5 into a reference file (e.g., references/skill-template.md) and link to it, keeping the main body lean and enabling progressive disclosure.

In Step 6, add an explicit remediation loop — 'if any gate fails, fix the issue and re-run the checklist' — to close the validation feedback gap.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no tutorials on what skills are, and every section (criteria table, naming rules, template, checklist) is operational. Minor trimming opportunities exist: the reserved-fragment rule appears in both Step 3 and the Step 6 checklist, and the ~40-line inline SKILL.md template could live in a reference file. It fits anchor 4's 'efficient; minor instances that could be trimmed' rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Mostly executable guidance: a copy-pasteable bash snippet for searching auto-memory, concrete naming rules with good/bad examples, an explicit output file layout, a full SKILL.md template, and two worked example invocations. The key gap is Step 4's 'Spawn the skill-extractor agent' — the core generation step gives no agent prompt or spec, so it falls just short of anchor 5's 'fully executable; copy-paste ready'.

4 / 5

Workflow Clarity

Seven clearly sequenced steps with an explicit validation checkpoint (the Step 6 quality-gates checklist before finalizing) and a concrete report format. It matches anchor 4's 'clear sequence with most checkpoints present; minor validation gaps' — there is no explicit fix-and-recheck loop when a gate fails, and file creation is not destructive so the anchor-3 cap for unvalidated batch/destructive operations does not apply.

4 / 5

Progressive Disclosure

No bundle files exist and the single SKILL.md is well organized with clear section headers and no nested references. The ~190-line body inlines the full generated-SKILL.md template and example block, which could be split into a reference file for a leaner main file, so it fits anchor 4's 'good structure; minor organization gaps' rather than anchor 5 (which the under-50-line simple-skill exception would require).

4 / 5

Total

16

/

20

Passed

Description

87%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 strong: it explicitly states what the skill produces (SKILL.md, reference docs, examples) and when to invoke it (the /si:extract command or a packaging request), with a clear niche and low conflict risk. The only weakness is modest trigger synonym coverage — natural user phrasings like 'save this as a skill' are not included.

DimensionReasoningScore

Specificity

The description names the domain (skill extraction) and several concrete deliverables — 'a standalone reusable skill with SKILL.md, reference docs, and examples' — but omits other actions the skill performs (naming rules, quality gates), leaving minor coverage gaps. It lists several specific actions rather than only 1-2, so it sits above the anchor 3 example but below anchor 5's comprehensiveness.

4 / 5

Completeness

Both halves are explicit: the 'what' is 'Turn a proven pattern or debugging solution into a standalone reusable skill with SKILL.md, reference docs, and examples' and the 'when' is the concrete 'Use when the user runs /si:extract or asks to package a recurring solution from memory into a skill'. This matches anchor 5's clear, explicit what-and-when with concrete trigger phrases, exceeding anchor 4's 'when could be more specific'.

5 / 5

Trigger Term Quality

Triggers include the concrete command '/si:extract' and the natural request phrasing 'asks to package a recurring solution from memory into a skill', which maps well to what a user would actually say. Common synonyms like 'save this as a skill', 'create a skill', or 'turn this fix into a skill' are absent, keeping it just below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — extracting a reusable skill from a proven pattern or debugging solution stored in memory — is distinct, and the '/si:extract' command trigger plus the memory-packaging phrasing minimize overlap with generic skill-creation or documentation skills. It matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk'; it is not merely 'mostly distinct' as in anchor 4.

5 / 5

Total

18

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

engineering-team/self-improving-agent/skills/extract/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.