CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Guide for creating effective skills. Use when creating a new skill or updating an existing skill that extends agent capabilities with specialized knowledge, workflows, or tool integrations.

63

Quality

75%

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

Quality

Content

77%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 guide with an exemplary six-step workflow, explicit validation feedback loops, and textbook progressive disclosure — every referenced bundle file exists, is one level deep, and is surfaced with a clear when-to-read condition. The weakest spot is token efficiency: conceptual explanations of what skills are, an analogy, and duplicated boilerplate notes could be trimmed or pushed to a reference file.

Suggestions

Trim background material Claude does not need (the 'What Skills Provide' list and the bridge/field analogy in 'Degrees of Freedom') to reduce token cost without losing guidance.

Deduplicate the repeated 'Note: The scripts are located in this skill's scripts/ directory' into a single sentence before the two script sections.

Show expected output or key flags for init_skill.py and package_skill.py (e.g., what the generated template looks like) so the commands are fully copy-paste predictable.

DimensionReasoningScore

Conciseness

The body is mostly efficient and imperative, but includes padding Claude does not need: the 'narrow bridge with cliffs' analogy, a four-item explanation of what skills are ('What Skills Provide'), and repeated boilerplate ('Note: The scripts are located in this skill's scripts/ directory...' appears twice). It fits anchor 3 (mostly efficient with some unnecessary explanation that could be tightened) better than anchor 4, which expects only minor trims.

3 / 5

Actionability

Guidance is largely executable: concrete commands ('python scripts/init_skill.py <skill-name> --path <output-directory>', 'python scripts/package_skill.py <path/to/skill-folder>'), a worked example description for a docx skill, and specific example questions. Minor gaps keep it at anchor 4 rather than 5 — e.g., no example invocation output for the scripts and the packaging 'optional output directory' shown as a second bare command rather than flags.

4 / 5

Workflow Clarity

The six-step creation process is clearly sequenced with explicit skip conditions per step, a mandatory test of added scripts ('must be tested by actually running them'), and a full validation feedback loop in packaging: validate automatically, '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, error-recovery feedback loop).

5 / 5

Progressive Disclosure

The body stays under its own 500-line limit, keeps core workflow and selection guidance inline, and signals two real one-level-deep reference files with explicit when-to-read conditions ('Multi-step processes: See references/workflows.md', 'output formats or quality standards: See references/output-patterns.md'), both of which exist in the bundle and match their descriptions. Scripts are similarly referenced by path. This matches anchor 5 (clear overview, well-signaled one-level-deep references, appropriate split).

5 / 5

Total

17

/

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 'Use when...' clause covering both creation and updates, a distinct niche, and decent trigger phrasing. Its main weakness is the 'what' side: capabilities are stated generically ('Guide for creating effective skills') rather than as concrete actions like designing, structuring, validating, and packaging skills.

Suggestions

Enumerate concrete capabilities in the 'what' portion (e.g., designing skill structure, writing SKILL.md frontmatter and body, bundling scripts/references/assets, validating and packaging skills into .skill files) instead of the generic 'Guide for creating effective skills'.

Add natural trigger synonyms users would say, such as 'building', 'authoring', or 'packaging a skill', and the filename 'SKILL.md', to broaden keyword coverage.

State when NOT to use the skill (e.g., not for writing ordinary documentation or prompts) to sharpen conflict avoidance.

DimensionReasoningScore

Specificity

The description names the domain ("creating effective skills") and two concrete actions ("creating a new skill or updating an existing skill"), but the remainder ("extends agent capabilities with specialized knowledge, workflows, or tool integrations") describes what skills are rather than what this skill does. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) and falls short of anchor 4, which expects several specific listed actions.

3 / 5

Completeness

Both parts are explicitly present: what ("Guide for creating effective skills") and when ("Use when creating a new skill or updating an existing skill..."). The 'when' clause is explicit and fairly specific, but the 'what' is thin — 'Guide for creating effective skills' does not enumerate concrete capabilities the way anchor 5's examples do, so it sits between anchors 4 and 5, closer to 4.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present: "creating a new skill", "updating an existing skill". It misses common variations like "building", "making", or "packaging a skill" and the filename "SKILL.md", so it fits anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Skill creation/updating is a clear niche with distinct triggers; no plausible competing skill would trigger on 'creating a new skill'. This matches anchor 5 (clear niche with distinct triggers, minimal conflict risk) — anchor 4's 'minor overlap risk with closely related skills' is not warranted.

5 / 5

Total

16

/

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
eigent-ai/eigent
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.