CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-skill

Guide for creating effective skills. This command 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. Use when creating new skills, editing existing skills, or verifying skills work before deployment - applies TDD to process documentation by testing with subagents before writing, iterating until bulletproof against rationalization

Quality

80%

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 ./plugins/customaize-agent/skills/create-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

The body is highly actionable with concrete templates, tables, and an explicit TDD workflow with validation checkpoints, but it is noticeably verbose due to repeated sections and is monolithic where splitting into references would help. Progressive disclosure and conciseness are the weakest dimensions.

Suggestions

Consolidate the three repeated presentations of skill directory structure ('Anatomy of a Skill', 'File Organization', and Step 3 of 'Skill Creation Process') into a single authoritative section to cut significant redundancy.

Move the CSO/description-authoring guidance and the persuasion-principles material into references/ files (e.g. references/cso.md, references/persuasion-principles.md) and keep only a one-line pointer plus core procedural guidance in SKILL.md.

Reconcile the overlapping RED-GREEN-REFACTOR, six-step 'Skill Creation Process', and checklist into one linear workflow so the validation checkpoints are not scattered across three sections.

DimensionReasoningScore

Conciseness

The body is mostly efficient and contains substantial concrete guidance, but it repeats the same material several times (directory structure appears in 'Anatomy of a Skill', 'File Organization', and 'Skill Creation Process Step 3'; description-authoring guidance appears in both 'SKILL.md Structure' and the 'CSO' section) and explains concepts like what a skill is that Claude already knows, fitting the 'mostly efficient but could be tightened' anchor rather than the lean level 4.

3 / 5

Actionability

It provides copy-paste-ready templates (YAML frontmatter, markdown structure), concrete tables (TDD mapping, rationalization table), a runnable dot flowchart, validation commands ('wc -w skills/path/SKILL.md'), and an explicit checklist, fully covering the common skill-creation cases per the level 5 anchor.

5 / 5

Workflow Clarity

The RED-GREEN-REFACTOR cycle and the six-step creation process are clearly sequenced with explicit validation checkpoints ('Run scenarios WITHOUT skill', 'verify agents now comply', 're-test until bulletproof', Step 5 'Validating the Skill'), but the workflow is fragmented across three overlapping presentations (cycle, process, checklist) leaving minor gaps, so it is just below the fully checklisted level 5.

4 / 5

Progressive Disclosure

Headers provide reasonable in-page navigation, but the skill is a monolithic ~840-line document with no bundle files present and content (testing methodology, CSO guidance, persuasion principles) that clearly belongs in separate references inlined; a referenced 'persuasion-principles.md' is not part of the bundle, matching the 'some structure but could be better organized' anchor.

3 / 5

Total

15

/

20

Passed

Description

83%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.

The description clearly states both what the skill does and when to use it, with concrete trigger phrases and a distinctive TDD framing. It is specific and third-person throughout, with only minor gaps in keyword synonyms and a slight overlap risk with sibling authoring skills.

DimensionReasoningScore

Specificity

Lists several concrete actions ('create a new skill (or update an existing skill)', 'applies TDD to process documentation', 'testing with subagents before writing', 'iterating until bulletproof against rationalization') with only minor coverage gaps, fitting the 'lists several specific actions' anchor rather than the fully comprehensive level 5.

4 / 5

Completeness

It explicitly answers both what ('Guide for creating effective skills... applies TDD to process documentation by testing with subagents before writing, iterating until bulletproof') and when ('Use when creating new skills, editing existing skills, or verifying skills work before deployment') with concrete trigger phrases, matching the level 5 anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ('creating new skills, editing existing skills, or verifying skills work before deployment') that users would plausibly say, but a few common synonyms like 'skill authoring' or 'writing skills' are missing, placing it just below the comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

The TDD-for-documentation framing carves a clear niche distinct from generic skill-authoring guidance, but there is minor overlap risk with related skill-authoring best-practices skills, so it sits at 'mostly distinct' rather than the minimal-conflict level 5.

4 / 5

Total

17

/

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

skill_md_line_count

SKILL.md is long (843 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

14

/

16

Passed

Repository

NeoLabHQ/context-engineering-kit

Path

plugins/customaize-agent/skills/create-skill/SKILL.md

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.