CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

my-skill

A brief description of what this skill does

Quality

26%

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 ./templates/skill-template/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

18%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 SKILL.md body is an unfilled scaffold: every section heading is appropriate, but all content beneath them is placeholder text ('Describe...', 'List any...'), no step is concrete, and the two referenced script files do not exist in the bundle. Actionability and workflow clarity are at the floor; only the section structure keeps progressive disclosure and conciseness slightly above it.

Suggestions

Replace every placeholder sentence with actual executable guidance — concrete commands showing how to invoke scripts/process.py and scripts/analyze.py (arguments, expected inputs/outputs), and real usage examples instead of '[do something]'.

Add the referenced scripts/process.py and scripts/analyze.py files (or remove the 'Tools Available' references), since the bundle currently contains no scripts, references, or assets at all.

Write an actual workflow: a numbered sequence with explicit validation/verification steps for any risky operations, and populate 'When to Use', 'Prerequisites', and 'Configuration' with real conditions, packages, and settings.

DimensionReasoningScore

Conciseness

The body is short (~30 lines) with no verbosity or over-explanation of known concepts, so it avoids the verbose anchors (1–2), but the tokens are placeholders like 'Clear instructions for the agent on how to use this skill.' that carry no instructional value — 'every token earns its place' (anchor 5) is not met, and anchor 4's 'minor instances of over-explanation' doesn't fit contentless text either. This lands at the midpoint: no waste through padding, but no earned tokens either.

3 / 5

Actionability

The entire body is unfilled template text: 'Describe the situations where this skill should be activated.', 'When the user asks to [do something], use this skill to [accomplish it].', 'List any required packages or tools.' There is no concrete code, no runnable command, and no specific instruction — matching anchor 1 ('Entirely vague or abstract; no concrete code or commands; only describes rather than instructs'). Even the listed tools get only 'Description of what this script does' with no invocation syntax, so it cannot reach 2.

1 / 5

Workflow Clarity

No sequence of steps exists anywhere — the sections are headings over placeholder sentences, with no ordering, no commands, and no validation checkpoints. This matches anchor 1 ('Steps missing or incoherent; no sequence; no validation for risky operations'); score 2 would require at least a rough sequence, which is absent.

1 / 5

Progressive Disclosure

The body has section headers and is under 50 lines (which could support a high simple-skill score), but its only external references — 'scripts/process.py' and 'scripts/analyze.py' — do not exist in the bundle (no scripts/, references/, or assets/ directories), so the disclosure structure is nominal: navigation points to nothing. This falls between anchor 1 (impossible-to-navigate nested references) and anchor 3 (structure present, references signaled) — the sections exist but every referenced path is dangling, so it sits noticeably below the midpoint.

2 / 5

Total

7

/

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 unfilled template placeholder text. It conveys no capability, no domain, no trigger guidance, and no distinguishing information, scoring the minimum on every dimension. It should be rewritten to name concrete actions and an explicit 'Use when...' trigger clause.

Suggestions

Replace the placeholder with concrete third-person actions and a domain, e.g. 'Extracts X from Y files and generates Z', following the pattern of the good examples ('Extract text and tables from PDF files, fill forms, merge documents.').

Append an explicit trigger clause such as 'Use when the user mentions [domain keywords, file extensions, or task phrases]' so both 'what' and 'when' are answered.

Include natural trigger keywords and synonyms (including relevant file extensions) that a user would actually say, to make the skill discoverable and distinct from other skills.

DimensionReasoningScore

Specificity

The description is literally 'A brief description of what this skill does' — pure placeholder text with no named domain and no concrete actions, exactly matching the anchor 'Entirely vague; no concrete actions; pure abstract language' (cf. 'Helps with documents'). It cannot score 2 because it does not even name a domain.

1 / 5

Completeness

Neither 'what' nor 'when' is present — the text describes itself as a description rather than stating any capability, and there is no 'Use when...' clause (which alone would cap this dimension at 3). This matches the anchor 'Missing both what and when, or both are extremely vague'.

1 / 5

Trigger Term Quality

There are no keywords of any kind — no domain nouns, no natural user phrases, no file extensions. It matches 'No natural keywords; only technical jargon or entirely generic language'; a score of 2 would require at least one or two generic keywords, which are absent.

1 / 5

Distinctiveness Conflict Risk

The text is entirely generic and provides no distinguishing signal, so it would conflict with virtually any skill, matching anchor 1. It cannot be 2 because even 'very broad' overlap examples like 'Helps with document files' at least identify a domain.

1 / 5

Total

4

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

ProwlrBot/prowlr-marketplace

Path

templates/skill-template/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.