CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

58

Quality

73%

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

Quality

Content

62%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 creation workflow with excellent validation and error-recovery structure, but its executable guidance is undermined by the bundle: the referenced package_skill.py is absent and the available quick_validate.py is undocumented. Moderate verbosity and a monolithic body leave room to tighten and offload detail to references.

Suggestions

Fix the script mismatch: either bundle scripts/package_skill.py or rewrite Step 5 around what actually ships (e.g., run scripts/quick_validate.py <skill-folder> for validation) and document quick_validate.py's usage in the body.

Trim promotional phrasing ('conveniently', 'much more efficient and reliable') and consolidate the duplicate scripts/references/assets explanations (anatomy tree plus detailed sections) into one pass.

Move the three worked planning examples (pdf-editor, frontend-webapp-builder, big-query) and detailed bundled-resource guidance into a references/ file (e.g., references/planning-examples.md), keeping SKILL.md to the workflow and key decisions.

DimensionReasoningScore

Conciseness

The body is mostly efficient and instructional, but includes padded/promotional phrasing ('The script conveniently generates... making the skill creation process much more efficient and reliable') and redundancy — the bundled-resources anatomy (scripts/references/assets) is explained once in the directory tree and again in detail, and the three-level loading system restates the per-directory benefits. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, which expects only minor trims.

3 / 5

Actionability

There is genuinely concrete guidance — the init command ('scripts/init_skill.py <skill-name> --path <output-directory>') matches the bundled script's actual usage, and three worked analysis examples (pdf-editor, frontend-webapp-builder, big-query) show exactly how to derive contents. But Step 5 instructs running 'scripts/package_skill.py', which does not exist in the bundle, and the existing 'quick_validate.py' is never referenced — so the packaging step cannot be executed as written. That is a missing key detail (anchor 3), more than the minor gaps of anchor 4.

3 / 5

Workflow Clarity

The six-step process is clearly sequenced (understand → plan → init → edit → package → iterate) with explicit per-step skip conditions, and Step 5 embeds a validation checkpoint plus an error-recovery loop: 'The packaging process automatically validates the skill first... If validation fails, the script will report the errors and exit without creating a package. Fix any validation errors and run the packaging command again.' This matches anchor 5 (clear sequence, explicit validation, feedback loop); anchor 4 would require a missing checkpoint, and none is evident since packaging validation covers the edit output.

5 / 5

Progressive Disclosure

Per the guideline to score against the actual bundle: 'scripts/init_skill.py' is correctly referenced, but 'scripts/package_skill.py' is referenced and missing (a broken navigation path), while the bundled 'quick_validate.py' is orphaned — never mentioned, so Claude cannot discover it. The ~1,660-word body is also monolithic; the worked examples and bundled-resource guidance could live in a references/ file. This lands at anchor 3 ('some structure but could be better organized'), short of anchor 4's 'references mostly clear; minor organization gaps' given the broken and orphaned script paths.

3 / 5

Total

14

/

20

Passed

Description

73%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 solid description with an explicit, well-phrased third-person trigger clause and a distinct niche. Its main weakness is that the capability statement ('Guide for creating effective skills') is generic — it omits the concrete activities (scaffolding via init script, packaging, validation) that would sharpen both the 'what' and trigger coverage.

Suggestions

Enumerate the concrete activities in the 'what' clause, e.g. 'Scaffolds new skills from a template, plans scripts/references/assets contents, and validates and packages skills for distribution. Use when creating or updating a skill that extends Claude's capabilities...'

Add common user phrasings as triggers (e.g. 'build', 'write', or 'make a skill') to broaden natural keyword coverage toward anchor 5.

DimensionReasoningScore

Specificity

The description names the domain ('creating effective skills') and two actions ('create a new skill (or update an existing skill)'), but the 'what' stays generic — it never mentions the guide's concrete capabilities (initialization scaffolding, packaging, validation) that the body actually provides. It fits anchor 3 (domain plus 1-2 actions, not comprehensive) better than anchor 4, which expects several specific listed actions; anchor 2 ('Processes PDF files'-level minimalism) is too weak given the create/update actions are named.

3 / 5

Completeness

Both parts are present: the 'what' ('Guide for creating effective skills') and an explicit 'when' ('This skill should be used when users want to create a new skill (or update an existing skill)...'). The when-clause is explicit and concrete, but the 'what' is high-level — it doesn't say what the guide covers (planning, init scripts, packaging, validation), so it falls at anchor 4 ('when' strong, 'what' could be more specific) rather than anchor 5's fully explicit both-what-and-when with concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural user phrases are present: 'when users want to create a new skill (or update an existing skill)' matches how users would actually ask. A few natural variations are missing ('build a skill', 'write a skill', 'make a skill'), matching anchor 4's 'good keyword coverage; a few natural terms missing'. Not anchor 5, which requires comprehensive synonyms/extensions coverage; not anchor 3, whose example ('Works with PDF files') has noticeably thinner trigger phrasing.

4 / 5

Distinctiveness Conflict Risk

Skill creation/updating is a clear meta-niche with distinct triggers ('create a new skill', 'update an existing skill') that users of other skills would virtually never say. This matches anchor 5 ('clear niche with distinct triggers; minimal conflict risk'); no neighboring anchor fits better since there is no meaningful overlap with document-, code-, or data-oriented skills.

5 / 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

referenced_paths_exist

Referenced path issues: 14 missing

Warning

Total

15

/

16

Passed

Repository

Raudbjorn/claude

Path

skill-creator/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.