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.

70

1.42x
Quality

56%

Does it follow best practices?

Impact

98%

1.42x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./data/skills-md/0xdarkmatter/claude-mods/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description successfully communicates when to use the skill with an explicit 'Use when' clause, but falls short on specificity—it doesn't describe concrete actions like generating frontmatter, structuring markdown, or validating skill files. The trigger terms are adequate but could include more natural variations users might say.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Generates YAML frontmatter, structures markdown instructions, defines trigger conditions, and validates skill file format.'

Include additional trigger term variations such as 'SKILL.md', 'skill file', 'write a skill', 'skill template', or 'custom workflow' to improve matching.

DimensionReasoningScore

Specificity

The description says 'creating effective skills' and 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations' but doesn't list concrete actions like 'generates YAML frontmatter, writes markdown instructions, validates skill structure.' The language is abstract and vague about what it actually does.

1 / 3

Completeness

It answers both 'what' (guide for creating effective skills) and 'when' ('should be used when users want to create a new skill or update an existing skill'). The 'when' clause is explicit with clear trigger conditions.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'create a new skill', 'update an existing skill', and 'skill' which users would naturally say. However, it misses variations like 'SKILL.md', 'skill file', 'write a skill', 'skill template', or 'custom instruction'.

2 / 3

Distinctiveness Conflict Risk

The term 'skill' is somewhat specific to this domain, but 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations' is broad enough to potentially overlap with other meta-skills or configuration-related skills. The niche is identifiable but not sharply delineated.

2 / 3

Total

8

/

12

Passed

Implementation

54%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill has excellent workflow clarity and progressive disclosure, effectively modeling the patterns it teaches. However, it is significantly too verbose—it spends many tokens explaining concepts Claude already understands (what skills are, what directories do, basic file organization) and includes extensive conceptual framing that doesn't earn its token cost. The actionability is moderate, with good concrete commands for init/package but mostly advisory guidance elsewhere.

Suggestions

Cut the 'About Skills' and 'What Skills Provide' sections entirely or reduce to 2-3 lines—Claude already understands these concepts and they consume significant tokens without adding actionable value.

Remove explanatory prose around bundled resources (scripts/, references/, assets/) and replace with a concise table or bullet list showing only the non-obvious guidance (e.g., the grep patterns tip, the >10k words threshold).

Consolidate the 'Core Principles' section—merge 'Concise is Key' and 'Set Appropriate Degrees of Freedom' into brief bullet points rather than multi-paragraph explanations with metaphors.

Add a concrete, complete example of a minimal SKILL.md (frontmatter + body) that could be copy-pasted as a starting point, rather than only showing fragments across multiple sections.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, explaining many concepts Claude already knows (what skills are, what PDFs are, what scripts/references/assets directories do). Extensive sections like 'What Skills Provide', 'About Skills', and detailed explanations of directory structures are largely unnecessary for Claude. The content could be cut by 50%+ while preserving all actionable guidance.

1 / 3

Actionability

The skill provides concrete commands (init_skill.py, package_skill.py) and a clear 6-step process, but much of the guidance remains at the level of principles and patterns rather than executable specifics. The code examples shown are illustrative directory structures and markdown snippets rather than executable code. The frontmatter writing guidance includes a good concrete example, but many sections remain advisory rather than directly actionable.

2 / 3

Workflow Clarity

The 6-step skill creation process is clearly sequenced with explicit ordering ('Follow these steps in order, skipping only if there is a clear reason'). Each step has clear entry/exit criteria (e.g., 'Conclude this step when there is a clear sense of the functionality'), and validation is built into Step 5 via the packaging script. The iteration feedback loop in Step 6 is also well-defined.

3 / 3

Progressive Disclosure

The skill practices what it preaches—it references external files like references/workflows.md, references/output-patterns.md, and the Anthropic skills repository for detailed patterns, keeping the main SKILL.md as an overview with clear navigation. References are one level deep and clearly signaled with descriptive context for when to consult them.

3 / 3

Total

9

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
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.