CtrlK
BlogDocsLog inGet started
Tessl Logo

example-skill

A sample skill for demonstration

42

Quality

42%

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 ./workspace/skills/example-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

The body gives clear, actionable guidance for a trivial greeting task and is appropriately compact. Its only weakness is a tangential paragraph about authoring skills that adds tokens without aiding execution.

DimensionReasoningScore

Conciseness

The body is short, but the second paragraph explaining how to create your own skills is tangential to executing /example and does not earn its place.

2 / 3

Actionability

For a trivial single-action demo skill, 'respond with a friendly greeting and explain that this is a demo skill' specifies the exact response content, making the action unambiguous.

3 / 3

Workflow Clarity

This is a simple single-purpose skill where the one action is unambiguous, so per the simple-skills note workflow clarity can score 3.

3 / 3

Progressive Disclosure

The skill is well under 50 lines with no need for external references, and the minimal section organization is adequate for content this small.

3 / 3

Total

11

/

12

Passed

Description

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.

The description is a placeholder-level label with no concrete capabilities, triggers, or use-when guidance. It tells Claude nothing actionable about when to invoke this skill.

Suggestions

Replace 'A sample skill for demonstration' with concrete actions the skill performs (e.g., 'Greets the user and explains the demo skill system').

Add an explicit trigger clause such as 'Use when the user invokes /example or asks about the demo skill.'

Use third-person action verbs and include natural terms a user would actually say to improve trigger matching.

DimensionReasoningScore

Specificity

The description 'A sample skill for demonstration' names no concrete actions, only an abstract purpose, matching the vague-language anchor.

1 / 3

Completeness

It answers neither what the skill concretely does nor when Claude should use it, with no 'Use when...' trigger guidance.

1 / 3

Trigger Term Quality

There are no natural keywords a user would actually say when needing this skill; 'sample skill for demonstration' is generic meta-language.

1 / 3

Distinctiveness Conflict Risk

The phrasing is so generic it could describe almost any skill and would conflict with many.

1 / 3

Total

4

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
shareAI-lab/claw0
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.