CtrlK
BlogDocsLog inGet started
Tessl Logo

flat-skill

A skill using a flat layout with all files at the root level.

30

Quality

23%

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 ./crates/skill-validator-rs/tests/golden-corpus/fixtures/testdata/flat-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%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 admirably lean but hollow: it delegates all detail to a guide.md that does not exist in the bundle and gives only vague, non-executable instructions for the two core steps. With the referenced files missing, the skill provides no actionable path for a reader to actually extract data or apply the template.

Suggestions

Provide the actual runnable commands, e.g. `python extract.py <source>` with expected arguments/output, and show concretely what 'apply template.txt' means (a command or a short example).

Fix the bundle: either include guide.md, extract.py, and template.txt in the skill directory or inline the essential instructions, since the current primary reference is a dangling pointer.

Add a lightweight validation step (e.g. how to verify the extracted data or formatted output looks correct) so the two-step workflow has a checkpoint.

DimensionReasoningScore

Conciseness

The body is roughly five lines with no padding and no explanation of concepts Claude already knows ("This skill uses a flat directory layout instead of the standard structure" is one brief factual line). It matches the anchor 'Lean and efficient; every token earns its place'; it cannot exceed 5, and it is well above anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

The instruction "Run extract.py to extract data from the source, then apply template.txt to format the output" names files but gives no runnable command, arguments, or explanation of how to 'apply' a template. This matches anchor 2 ('high-level hints but missing the specific steps to execute'); it is above anchor 1 because specific files are named, but below anchor 3, which requires at least some concrete executable detail.

2 / 5

Workflow Clarity

A rough two-step sequence exists (extract, then format), but the steps are poorly defined — how to run the script, what 'the source' is, and what applying a template means are all unstated, and there is no validation of any kind. This matches anchor 2; anchor 3 would require steps that are actually defined even if validation is missing, and this is not a destructive/batch operation so no further cap applies.

2 / 5

Progressive Disclosure

The body points to guide.md, extract.py, and template.txt, but none of these files exist in the bundle (only SKILL.md is present), so the primary navigation path ('Refer to guide.md for detailed instructions') is broken and the actual instructions are unreachable. Scored against the actual bundle structure per the guidelines, this is 'minimal structure; references buried/broken' (anchor 2); it is above anchor 1 because the body itself is short and one-level-deep rather than a monolithic wall, but below anchor 3 because the referenced files are missing rather than merely unclear.

2 / 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 documents the skill's directory layout rather than what the skill does or when to use it. It contains no concrete capabilities, no trigger terms, and nothing that distinguishes it from other skills, so a user (or Claude) could never select it based on the description alone. The actual functionality (running extract.py, applying template.txt) is only discoverable in the body.

Suggestions

Rewrite the description around capabilities, e.g. 'Extracts data from a source and formats the output using a text template', rather than describing the flat directory layout.

Add an explicit trigger clause: 'Use when the user needs to extract data from a source file or format extracted output with a template.'

Include the concrete artifacts users would mention naturally (e.g. the source format, template files) to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description states only that it is "a skill using a flat layout with all files at the root level" — this describes file organization, not capabilities, and contains no concrete actions whatsoever. It matches the anchor 'Entirely vague; no concrete actions; pure abstract language' and never rises to anchor 2, which requires at least naming a task domain.

1 / 5

Completeness

Neither question is answered: the functional 'what' (extract data, format output via template) is entirely unstated, and there is no 'Use when...' or equivalent trigger clause. The missing trigger clause alone caps completeness at 3; here even the 'what' is missing, matching anchor 1 rather than anchor 2's 'vague what and no when'.

1 / 5

Trigger Term Quality

Phrases like "flat layout" and "root level" are structural jargon no user would say when they need this skill; there are no natural task keywords (the actual tasks — extracting data, formatting output — appear only in the body). Anchor 1 fits; anchor 2 requires at least one or two generic task keywords, which are absent.

1 / 5

Distinctiveness Conflict Risk

Describing a directory layout ("flat layout", "all files at the root level") is generic across skills and provides no task-based distinguishing triggers, so it conflicts with virtually any other skill. This is a clear anchor-1 match; anchor 2 would require at least a broad functional domain like 'helps with document files'.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.