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.

79

1.25x
Quality

77%

Does it follow best practices?

Impact

79%

1.25x

Average score across 7 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

85%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-constructed instructional skill: a clearly sequenced six-step workflow with explicit validation feedback loops, executable commands for initialization and packaging, and exemplary progressive disclosure that both practices and teaches one-level-deep referencing. The only slack is minor — a couple of decorative analogies, a redundant opening line, and script invocations that omit the interpreter and full flag list.

DimensionReasoningScore

Conciseness

The body is disciplined — imperative voice throughout, examples over verbose explanation, and it explicitly tells the reader to challenge every token ("Does this paragraph justify its token cost?"). Minor trimmable instances exist: the "narrow bridge with cliffs" analogy, the "onboarding guides" metaphor in About Skills, and the opening line that repeats the frontmatter description. These are minor over-explanations, matching the score-4 anchor; score 5 would require every token earning its place with no analogies or restatement.

4 / 5

Actionability

Concrete, copy-paste-ready commands anchor the process: "scripts/init_skill.py <skill-name> --path <output-directory>" and "scripts/package_skill.py <path/to/skill-folder> ./dist", plus literal user questions and worked analysis examples (pdf-editor, frontend-webapp-builder, big-query). It falls just short of fully-executable score 5 because the script invocations omit the interpreter (no `python scripts/init_skill.py`), the init script's flags are not enumerated, and no example SKILL.md frontmatter/body pair is shown end-to-end. It is well above score 3, which expects pseudocode or missing key details.

4 / 5

Workflow Clarity

The six-step creation process is clearly sequenced with explicit skip conditions ("Follow these steps in order, skipping only if there is a clear reason"), and feedback loops are present for the risky operations: "Added scripts must be tested by actually running them", the packaging step "automatically validates the skill first", and "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" — a validate → fix → retry loop. This matches the score-5 anchor (explicit validation steps, feedback loops for error recovery).

5 / 5

Progressive Disclosure

The 355-line body stays under the 500-line guidance and splits content one level deep with clear signaling: "Multi-step processes: See references/workflows.md" and "output-patterns.md" — both real files whose contents match their descriptions — with no nested references (the body explicitly warns "Keep references one level deep"). It also teaches the pattern itself with three concrete splitting examples (PDF, BigQuery, cloud-deploy). Verified against the actual bundle: references/ contains exactly the two cited files, and scripts/ contains the three cited scripts.

5 / 5

Total

18

/

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 with an explicit and specific 'use when' clause and natural trigger phrasing. Its main weakness is that the 'what' half is a single generic word ("Guide") rather than a list of concrete capabilities, which limits specificity and completeness. It clearly avoids the vague one-liner failure mode.

Suggestions

Replace the generic "Guide for creating effective skills" with the concrete capabilities, e.g. "Creates and packages new skills: initializes skill directories, writes SKILL.md frontmatter and body, bundles scripts/references/assets, and validates before distribution."

Add natural trigger synonyms users would say, such as "build a skill", "make a new skill", or "skill creation", to broaden the trigger terms without adding length.

Follow the pattern of the skill's own docx example — enumerate the main tasks parenthetically (e.g., "for: (1) creating a new skill, (2) updating an existing skill, (3) packaging a skill for distribution").

DimensionReasoningScore

Specificity

"Guide for creating effective skills" names the domain plus one concrete action (creating), and "(or update an existing skill)" adds a second, but coverage of what the skill actually provides (init script, packaging, design guidance) is not comprehensive. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — above score 2 ('Processes PDF files'-level genericity) because creating/updating are real actions, below score 4 which expects several specific listed actions.

3 / 5

Completeness

Both parts are explicit: what — "Guide for creating effective skills"; 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 specific, but the 'what' is a generic single word ("Guide") without enumerating capabilities, so it does not clearly reach the score-5 anchor requiring both to be concretely stated; it is above score 3 because no half is missing or merely implied.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present: "create a new skill", "update an existing skill", plus contextual terms "specialized knowledge, workflows, or tool integrations". It falls just short of the score-5 anchor because common synonyms users might actually say ("build a skill", "make a skill", "skill creation") are absent, but it is well above score 3's 'some relevant keywords, missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The niche — creating/updating skills — is a distinct meta-task with triggers unlikely to fire for ordinary coding requests, and the "(or update an existing skill)" qualifier sharpens it. Minor overlap risk remains with adjacent requests (e.g., authoring CLAUDE.md, prompting/configuration questions that could be read as "extending Claude's capabilities with specialized knowledge"), which keeps it just below score 5's 'clear niche with distinct triggers; minimal conflict risk'.

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

relative_links

Relative link issues: 6 missing

Warning

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

14

/

16

Passed

Repository
vercel-labs/json-render
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.