CtrlK
BlogDocsLog inGet started
Tessl Logo

valid-skill

A valid skill for testing purposes.

28

Quality

18%

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 ./packages/coding-agent/test/fixtures/skills/valid-skill/SKILL.md

The canonical home for this skill is valid-skill in can1357/oh-my-pi

SKILL.md
Quality
Evals
Security

Quality

Content

37%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 a placeholder with no actionable guidance or workflow, scoring only well on conciseness and trivial structure. It tells Claude nothing about how to actually perform the skill.

Suggestions

Replace the generic statement with the concrete, executable steps or code needed to perform the skill's task.

If the skill is multi-step, add an explicit numbered workflow with validation checkpoints for any risky operations.

Move any lengthy reference material into separate files referenced one level deep from the body.

DimensionReasoningScore

Conciseness

The body is just a heading and one sentence with no padding or over-explanation, so it respects the token budget; it is efficient but the single sentence carries little useful signal, keeping it just below a 5.

4 / 5

Actionability

'This is a valid skill that follows the Agent Skills standard' gives no concrete, executable guidance — it describes rather than instructs, matching the score-1 anchor.

1 / 5

Workflow Clarity

There are no steps, no sequence, and no described action to sequence; even for a simple skill the single action is undefined, matching the score-1 anchor.

1 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and the content is trivially well-organized, so the simple-skill exception allows a 5 with no bundle files present.

5 / 5

Total

11

/

20

Passed

Description

0%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 is a placeholder that conveys no real capability, no trigger terms, and no use-when guidance. It fails on every dimension and is not actionable for selection.

Suggestions

State the concrete actions the skill performs, e.g. 'Extracts text and tables from PDF files, fills forms, merges documents.'

Add an explicit 'Use when...' clause naming natural trigger phrases (e.g. 'Use when the user mentions PDFs, forms, or document extraction').

Use third-person active voice describing specific behaviors rather than the meta-label 'A valid skill for testing purposes'.

DimensionReasoningScore

Specificity

The phrase 'A valid skill for testing purposes' names no domain and no concrete actions; it is pure abstract language matching the score-1 anchor 'Helps with documents'.

1 / 5

Completeness

It answers neither 'what does this do' (no real capability stated) nor 'when should Claude use it' (no trigger guidance at all), matching the missing-both anchor.

1 / 5

Trigger Term Quality

'valid skill for testing purposes' contains no natural keywords a user would say to invoke this skill; it is generic rather than technical-but-relevant.

1 / 5

Distinctiveness Conflict Risk

The description is entirely generic and would overlap with virtually any skill, matching the score-1 conflict-risk anchor.

1 / 5

Total

4

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Kiz8-Team/pi-cwl
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.