CtrlK
BlogDocsLog inGet started
Tessl Logo

test/tom-test

tesing creation of new skills

16

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

Discovery

0%

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

This description is essentially a placeholder or test entry with no meaningful content. It contains a typo ('tesing'), provides no concrete capabilities, no trigger terms, and no guidance on when to use the skill. It would be completely ineffective for skill selection.

Suggestions

Rewrite the description to specify concrete actions the skill performs (e.g., 'Creates new skill files with proper YAML frontmatter and markdown structure').

Add a 'Use when...' clause with explicit trigger terms (e.g., 'Use when the user asks to create a new skill, add a skill template, or scaffold skill files').

Define a clear domain and scope to distinguish this skill from others (e.g., focus on skill file creation vs. general file creation).

DimensionReasoningScore

Specificity

The description 'tesing creation of new skills' contains no concrete actions whatsoever - it's vague, abstract, and doesn't describe any capabilities.

1 / 3

Completeness

Fails to answer both 'what does this do' and 'when should Claude use it'. There is no 'Use when...' clause and no meaningful description of functionality.

1 / 3

Trigger Term Quality

Contains no natural keywords users would say when needing this skill. 'tesing' appears to be a typo for 'testing' and 'creation of new skills' is not a phrase users would naturally use.

1 / 3

Distinctiveness Conflict Risk

Extremely generic and unclear - could conflict with virtually any skill since it doesn't define a specific domain or use case.

1 / 3

Total

4

/

12

Passed

Implementation

0%

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

This skill is essentially a blank template with only a TODO placeholder. It provides no instructions, examples, code, or guidance of any kind. The skill cannot be used in its current state and requires complete content creation.

Suggestions

Add concrete, executable instructions describing what task this skill should accomplish

Include at least one code example or specific command that Claude can execute

Define the scope and purpose of the skill in actionable terms rather than a TODO placeholder

If the skill involves multiple steps, add a clear numbered workflow with validation checkpoints

DimensionReasoningScore

Conciseness

The content is essentially empty with only a placeholder TODO comment, providing no actual instructions or value while still consuming tokens.

1 / 3

Actionability

No concrete guidance, code, commands, or examples are provided - just a placeholder indicating content needs to be added.

1 / 3

Workflow Clarity

No workflow, steps, or processes are defined; the skill contains no actionable sequence whatsoever.

1 / 3

Progressive Disclosure

No structure, organization, or references exist; the content is a single placeholder line with no navigation or content hierarchy.

1 / 3

Total

4

/

12

Passed

Validation

62%

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

Validation10 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

description_trigger_hint

Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...')

Warning

metadata_version

'metadata' field is not a dictionary

Warning

license_field

'license' field is missing

Warning

body_examples

No examples detected (no code fences and no 'Example' wording)

Warning

body_output_format

No obvious output/return/format terms detected; consider specifying expected outputs

Warning

body_steps

No step-by-step structure detected (no ordered list); consider adding a simple workflow

Warning

Total

10

/

16

Passed

Install with Tessl CLI

npx tessl i test/tom-test

Reviewed

Table of Contents