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.

64

1.31x
Quality

46%

Does it follow best practices?

Impact

96%

1.31x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/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 succeeds in providing explicit 'when to use' guidance but falls short on specificity of what concrete actions the skill performs. It reads more like a high-level summary than a detailed capability listing, using abstract language like 'extends capabilities' instead of naming concrete outputs or steps. The trigger terms are adequate but could be expanded with more natural variations.

Suggestions

Replace vague capability language with specific actions, e.g., 'Generates SKILL.md files with proper YAML frontmatter, writes structured markdown content, validates skill format and description quality'.

Add more natural trigger term variations such as 'SKILL.md', 'skill file', 'teach Claude', 'custom skill', 'skill template' to improve matching coverage.

DimensionReasoningScore

Specificity

The description uses vague language like 'creating effective skills' and 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations' without listing concrete actions. It doesn't specify what the skill actually does (e.g., generates YAML frontmatter, writes markdown templates, validates skill structure).

1 / 3

Completeness

It explicitly 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 'Use when' clause is clearly present with explicit triggers.

3 / 3

Trigger Term Quality

It includes some relevant trigger terms like 'create a new skill', 'update an existing skill', and 'skill' itself, which users might naturally say. However, it misses variations like 'SKILL.md', 'skill file', 'custom instruction', 'teach Claude', or 'skill template'.

2 / 3

Distinctiveness Conflict Risk

The term 'skill' provides some distinctiveness, but phrases like 'specialized knowledge, workflows, or tool integrations' are broad enough to potentially overlap with other meta-skills or documentation-related skills. It's somewhat specific to skill creation but could conflict with general documentation or template skills.

2 / 3

Total

8

/

12

Passed

Implementation

35%

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

This is a comprehensive meta-skill for creating skills, but it suffers from significant verbosity—it explains many concepts Claude already understands (what scripts are, what assets are, basic file organization) and includes redundant information across sections. The 6-step workflow is well-structured but lacks integrated validation checkpoints. The skill would benefit greatly from practicing what it preaches: moving detailed reference material into separate files and keeping SKILL.md lean with only essential procedural guidance.

Suggestions

Reduce verbosity by removing explanations of concepts Claude already knows (e.g., what PDFs are, what scripts/references/assets mean, what README files are) and trust Claude's intelligence—this could cut the content by 30-40%.

Move the detailed 'Progressive Disclosure Patterns' section and 'Core Principles' elaborations into a references/ file, keeping only a brief summary and link in SKILL.md—practice the progressive disclosure the skill itself teaches.

Add a concrete validation checkpoint between Step 4 (Edit) and Step 5 (Package)—e.g., a checklist of 'verify SKILL.md is under 500 lines, verify all referenced files exist, verify frontmatter description covers all triggers'.

Include a complete, minimal example of a finished SKILL.md (frontmatter + body) as a concrete reference, rather than only showing fragments across different sections.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, with significant portions explaining concepts Claude already knows (what skills are, what PDFs are, what scripts/references/assets mean conceptually). Many sections contain redundant explanations—e.g., the 'What Skills Provide' list, the lengthy explanations of each resource type with multiple bullet points restating obvious information, and the 'What to Not Include' section listing specific filenames Claude doesn't need enumerated.

1 / 3

Actionability

The skill provides concrete commands for init and packaging scripts (`scripts/init_skill.py`, `scripts/package_skill.py`) and includes structural examples of skill directories. However, much of the guidance remains at the level of principles and heuristics rather than executable steps—e.g., the 'Core Principles' section is largely conceptual, and the SKILL.md writing guidelines lack a concrete before/after example of a well-written skill body.

2 / 3

Workflow Clarity

The 6-step creation process is clearly sequenced and each step is well-labeled. However, validation checkpoints are mostly delegated to the packaging script at Step 5 rather than being integrated throughout—there's no explicit checkpoint after Step 4 to verify SKILL.md quality before packaging, and the testing guidance in Step 4 ('Added scripts must be tested') lacks specific validation commands or criteria for success.

2 / 3

Progressive Disclosure

The skill references `references/workflows.md` and `references/output-patterns.md` for additional patterns, which is good progressive disclosure. However, the SKILL.md itself is monolithic—much of the detailed content about resource types, progressive disclosure patterns, and design principles could be split into reference files. The extensive inline examples of directory structures and patterns bloat the main file significantly.

2 / 3

Total

7

/

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
heimeshoff/Mediatheca
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.