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.

84

1.36x
Quality

76%

Does it follow best practices?

Impact

100%

1.36x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/compound-engineering/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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 adequately communicates when to use the skill with explicit trigger guidance, making it complete. However, it lacks specificity about what concrete actions the skill enables (e.g., writing frontmatter, structuring content, defining triggers) and could benefit from additional natural trigger terms users might employ.

Suggestions

Add specific concrete actions the skill enables, such as 'write YAML frontmatter, structure skill content, define trigger conditions, and integrate tool workflows'

Expand trigger terms to include variations like 'SKILL.md', 'write a skill', 'skill file', 'extend Claude's capabilities', or 'add new capability'

DimensionReasoningScore

Specificity

Names the domain (creating skills) and mentions some actions ('create a new skill', 'update an existing skill'), but lacks concrete specific actions like 'write YAML frontmatter', 'define trigger conditions', or 'structure skill content'.

2 / 3

Completeness

Clearly answers both what ('Guide for creating effective skills') and when ('when users want to create a new skill or update an existing skill') with explicit trigger guidance using 'This skill should be used when...' clause.

3 / 3

Trigger Term Quality

Includes relevant keywords like 'skill', 'create', 'update', but misses common variations users might say such as 'write a skill', 'new capability', 'skill file', 'SKILL.md', or 'extend Claude'.

2 / 3

Distinctiveness Conflict Risk

Has a clear niche focused specifically on skill creation/updating, which is distinct from general documentation or coding skills. The trigger terms 'create a new skill' and 'update an existing skill' are specific enough to avoid conflicts.

3 / 3

Total

10

/

12

Passed

Implementation

77%

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

This is a solid, actionable skill with clear workflows and executable guidance. Its main weakness is verbosity in the introductory sections that explain concepts Claude already understands. The step-by-step process is well-designed with built-in validation, but the 'About Skills' section adds ~400 tokens of conceptual explanation that could be significantly condensed.

Suggestions

Condense or remove the 'About Skills' and 'What Skills Provide' sections - Claude understands what skills are; focus on the procedural 'how' rather than conceptual 'what'

Move the detailed 'Anatomy of a Skill' section to a references/anatomy.md file and summarize in SKILL.md with a link

Tighten the examples in Step 2 - the pattern is clear after one example; three full examples with analysis is verbose

DimensionReasoningScore

Conciseness

The skill contains some unnecessary explanation (e.g., explaining what skills are to Claude, the 'About Skills' section with conceptual framing). While mostly efficient, sections like 'What Skills Provide' and the anatomy explanation could be tightened since Claude understands these concepts.

2 / 3

Actionability

Provides concrete, executable commands (init_skill.py, package_skill.py with exact usage), specific directory structures, and clear examples of what to include in each resource type. The step-by-step process is copy-paste ready.

3 / 3

Workflow Clarity

Clear 6-step sequential process with explicit validation built into Step 5 (packaging validates automatically). Each step has clear entry/exit criteria, and Step 6 provides an iteration feedback loop for error recovery.

3 / 3

Progressive Disclosure

Content is well-structured with clear sections, but the skill is somewhat monolithic. The detailed anatomy section and examples could potentially be moved to reference files. However, navigation within the document is clear with good headers.

2 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
EveryInc/compound-engineering-plugin
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.