CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-development

This skill should be used when the user asks to create a new skill, repair an existing skill, improve trigger descriptions, reorganize skill structure, or make a Claude skill more reusable and internally consistent.

65

Quality

78%

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 ./skills/skill-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 lean, well-structured instruction-only skill with a clear six-step workflow, explicit closing integrity checks, and exemplary progressive disclosure — all referenced bundle files exist, are one level deep, and are annotated. Minor gaps: some redundancy across sections and no error-recovery loop after the integrity checks.

Suggestions

Consolidate the dead/stale-reference guidance, which is repeated in Core rules, step 1, step 6, and the repair patterns, into a single rule plus the reference file.

Add a short feedback loop after step 6 ("If a check fails, fix the issue and re-run the checks before closing") to lift workflow clarity.

DimensionReasoningScore

Conciseness

The body is efficient — short goal, rules, and a lean workflow — and assumes Claude's competence without explaining known concepts. It falls short of anchor 5 because several points repeat across sections (dead references appear in Core rules, step 1, step 6, and the repair patterns; "keep it lean" is restated in rules, step 4, and repair patterns), so not every token earns its place.

4 / 5

Actionability

The guidance is concrete for an instruction-only skill: a six-step workflow, a specific yaml frontmatter template, explicit rules ("If a resource is mentioned in SKILL.md, it must exist"), and a closing checklist of integrity checks. It stops short of anchor 5 because verification steps are listed but not executable (no commands inline — though concrete commands live in references/integrity-checks.md, they are not surfaced in the body).

4 / 5

Workflow Clarity

A clear numbered six-step sequence runs from environment inspection to closing integrity checks, with step 6 serving as an explicit validation checkpoint. It does not reach anchor 5 because there is no feedback loop (what to do when an integrity check fails) and no explicit ordering emphasis; it stays above anchor 3 because the validation step is explicit, not merely implied.

4 / 5

Progressive Disclosure

The body is a well-organized overview (goal, rules, workflow, repair patterns, references) and all three referenced files — references/checklist.md, references/integrity-checks.md, and references/skill-creator-original.md — exist on disk, are described with one-line summaries, and are one level deep with no nested chains. "Load only what is needed" plus per-file purpose statements matches the anchor-5 pattern of clear navigation with appropriately split content.

5 / 5

Total

17

/

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, third-person trigger description following the recommended "This skill should be used when the user asks to..." pattern, with an explicit when-clause and a clear niche. Its main weakness is that the "what" is only implied by the trigger verb list, and it lacks a few natural synonyms (fix, write, refactor, SKILL.md).

Suggestions

State the skill's actual function before the trigger clause, e.g. "Guides creating and repairing Claude skills (SKILL.md files, bundled references). Use when the user asks to...".

Add natural trigger variations users would say — "fix a skill", "write a new skill", "refactor a skill", or mentions of SKILL.md / frontmatter descriptions.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "create a new skill, repair an existing skill, improve trigger descriptions, reorganize skill structure" — with only minor vagueness in the final clause ("more reusable and internally consistent"). It does not reach anchor 5 because the actions are process-level rather than fully concrete outcomes, and the tail phrase is abstract.

4 / 5

Completeness

The "when" is explicit ("This skill should be used when the user asks to...") with concrete trigger phrases, and the verb list doubles as the "what". It falls short of anchor 5 because the "what" is only implicit in the trigger list — the skill's actual guidance activity is never stated separately, a slightly weaker form than the anchor-5 example that states capabilities first.

4 / 5

Trigger Term Quality

It includes natural phrases users would say ("create a new skill", "repair an existing skill", "improve trigger descriptions", "reorganize skill structure"), giving good keyword coverage. It misses common variations like "fix a skill", "write a skill", "refactor a skill", or "SKILL.md", so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Claude skill" authoring and repair is a clear niche with distinct triggers (skill creation, trigger descriptions, skill structure, reusability), so conflict risk with other skills is minimal. It matches the anchor-5 pattern of a distinct domain with dedicated trigger phrases rather than overlapping generic wording.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.