CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

78

1.17x
Quality

68%

Does it follow best practices?

Impact

99%

1.17x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/all-skills/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, genuinely actionable instruction skill: a clear six-step creation workflow with an embedded validation feedback loop and concrete script commands backed by real bundle files. The main costs are redundancy between the anatomy overview and the per-directory sections, and an implicit (never-instructed) testing step.

Suggestions

Collapse the directory descriptions: keep either the anatomy tree or the Scripts/References/Assets subsections, not both — currently 'Documentation intended to be loaded into context as needed' appears in two places nearly verbatim.

Add a concrete testing instruction in Step 6 (e.g., how to exercise the new skill on one of the Step 1 example prompts and what a pass looks like), since 'After testing the skill' currently assumes a step that was never defined.

Mention quick_validate.py in the body (e.g., 'run scripts/quick_validate.py for a fast check without packaging') so all three bundled scripts are discoverable, and prefix the two script commands with 'python' for copy-paste reliability.

DimensionReasoningScore

Conciseness

The body is mostly efficient but carries noticeable redundancy: the anatomy tree (lines 30-41) repeats the same directory descriptions that the 'Scripts/References/Assets' subsections then restate with near-identical wording, and the frontmatter 'Metadata Quality' advice overlaps with Step 4's writing guidance. It is not severely padded with concepts Claude already knows (the skill-anatomy material is the skill's actual subject matter), so it sits at the 'could be tightened' level 3 anchor rather than level 2, but it is not the lean 'every token earns its place' level 5.

3 / 5

Actionability

Guidance is mostly executable: concrete commands ('scripts/init_skill.py <skill-name> --path <output-directory>', 'scripts/package_skill.py <path/to/skill-folder> ./dist'), specific user-question examples for Step 1, and three worked analysis examples (pdf-editor, frontend-webapp-builder, big-query). Minor gaps keep it below 5: the commands are shown without a 'python' invocation prefix, and there is no concrete example of what a finished SKILL.md passage or frontmatter description should look like.

4 / 5

Workflow Clarity

A clearly sequenced six-step process with per-step skip conditions, and the packaging step includes an explicit validate-on-fail loop ('If validation fails, the script will report the errors... Fix any validation errors and run the packaging command again'). The gap that keeps it at 4 rather than 5 is testing: Step 6 opens with 'After testing the skill' without ever instructing how to actually test or verify a newly created skill, so that checkpoint is implicit.

4 / 5

Progressive Disclosure

Scored against the actual bundle (scripts/init_skill.py, package_skill.py, quick_validate.py; no references/ or assets/): both scripts referenced in the body are real, invoked with exact paths, and are one level deep with no nested-reference chains; the body itself is well-sectioned and under 5k words. Minor gaps: quick_validate.py is bundled but never surfaced in SKILL.md (it is silently imported by package_skill.py), and the illustrative paths like 'references/finance.md' are hypothetical examples rather than signals of real files, so navigation is good but not fully clean.

4 / 5

Total

15

/

20

Passed

Description

70%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 that follows best practice: third-person voice, an explicit 'should be used when' trigger, and a clear niche. Its main weakness is that the 'what' is generic — it never concretely lists the skill's capabilities (planning, scripting, packaging, validation), which caps specificity and completeness.

Suggestions

Enumerate 3-4 concrete capabilities in the description, e.g., 'Guides planning skill contents, writing SKILL.md metadata and instructions, and packaging/validating skills with bundled scripts.'

Add natural trigger synonyms users might say, such as 'build', 'write', or 'author a skill', and mention updating/improving an existing skill earlier in the sentence.

Trim the abstract tail ('specialized knowledge, workflows, or tool integrations') in favor of concrete capability words — it adds length without trigger value.

DimensionReasoningScore

Specificity

The description names the domain ("creating effective skills") and effectively two actions — "create a new skill (or update an existing skill)" — which matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It does not enumerate what the skill actually covers (planning contents, writing SKILL.md, packaging, validation), so it is not a 4, and it is more concrete than the minimal/generic 'Processes PDF files' level 2 example.

3 / 5

Completeness

It answers both questions: what ("Guide for creating effective skills") and an explicit third-person when-clause ("This skill should be used when users want to create a new skill (or update an existing skill)"). The 'when' is explicit but the 'what' is a single generic sentence rather than concrete capability enumeration, so it sits at the level 4 anchor ('both present, when could be more explicit/specific') rather than the level 5 example's fully concrete trigger-phrase coverage.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: "create a new skill", "update an existing skill", plus 'skill' as the domain noun — good keyword coverage. A few natural synonyms are missing (e.g., 'build', 'write', 'author', 'skill-creator', 'extend Claude's capabilities' is more jargon than a user phrase), which keeps it below the comprehensive level 5 anchor with synonyms and file extensions.

4 / 5

Distinctiveness Conflict Risk

Skill creation is a clear niche with a distinct trigger ("create a new skill"), giving minimal conflict risk with most skills. Minor overlap risk remains with adjacent meta-tooling (e.g., agent, plugin, or command authoring), and the broad tail 'specialized knowledge, workflows, or tool integrations' slightly dilutes the niche, keeping it just below the level 5 anchor.

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

14

/

16

Passed

Repository
davepoon/buildwithclaude
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.