CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auxiliary-only-skill

A skill that uses only shell and config code blocks for testing contamination.

49

Quality

62%

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

Quality

Content

78%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 compact, executable setup-config-run guide with clean section structure and no padding beyond a slightly redundant intro line. Its main weaknesses are a missing validation step after starting the service and a referenced start.sh that is not part of the bundle.

Suggestions

Trim the opening meta-sentence ('This skill uses bash commands and config files but no application languages') — it adds no execution guidance.

Keep only one config example format (or explicitly justify offering both YAML and JSON) to remove duplication.

Add a quick validation step after starting the service (e.g., 'curl -s localhost:8080/health') so the workflow has a checkpoint.

DimensionReasoningScore

Conciseness

The body is lean and command-first with no concept explanations Claude already knows, but the opening line 'This skill uses bash commands and config files but no application languages' restates the frontmatter's meta-purpose, and the YAML and JSON config blocks are duplicative. Anchor 4 (efficient, minor over-content) fits better than 5, where every token would earn its place.

4 / 5

Actionability

Commands are concrete and executable as written: 'brew install jq yq', complete config blocks, and './start.sh --config config.yaml'. It is not a 5 because start.sh is not provided anywhere in the bundle and no common-case variations are covered, leaving a minor gap.

4 / 5

Workflow Clarity

Setup -> Configuration -> Running is a clearly sequenced, executable three-step workflow with each step's command given. There are no validation checkpoints (e.g., verifying the service is up), so it fits anchor 4 rather than 5; the simple-skill 5 exception does not fully apply since this is a multi-step process, though nothing destructive/batch triggers the cap at 3.

4 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained with no bundle files needed, and organized under clear section headers (Setup, Configuration, Running). Per the simple-skill guideline, this matches anchor 5 — well-organized sections with no nested or buried references.

5 / 5

Total

17

/

20

Passed

Description

28%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 reads as an internal test-fixture label rather than a skill description: it states what the skill contains instead of what it does, and gives no usage triggers. It would rarely be selected by a user's natural request.

Suggestions

State concrete capabilities in third person (e.g., 'Installs CLI tools, writes YAML/JSON config files, and launches a service') instead of describing the skill's composition.

Add an explicit trigger clause, e.g., 'Use when setting up or running services configured via shell commands and YAML/JSON config files.'

Include natural user-facing terms and synonyms (shell, bash, config files, .yaml, .json) so the description matches how users actually phrase requests.

DimensionReasoningScore

Specificity

The description 'A skill that uses only shell and config code blocks for testing contamination' names a domain (shell and config code blocks) but describes composition rather than any concrete capability or action. It matches anchor 2 (names the domain, minimal/generic actions) — not 3, which requires 1-2 concrete actions, and not 1, since it is not pure abstract language.

2 / 5

Completeness

The 'what' is vague — it states what the skill is composed of, not what it does — and there is no 'when to use' guidance at all. Per the guideline, the missing 'Use when...' clause caps completeness at 3; it lands at 2 (vague what, no when) because the what itself never states a capability.

2 / 5

Trigger Term Quality

Terms like 'shell', 'config code blocks', and 'testing contamination' are technical/meta jargon; no natural phrases a user would say when needing this skill are present. Fits anchor 2 (one or two generic keywords, missing natural phrases) rather than 1, since 'shell' and 'config' are not entirely generic.

2 / 5

Distinctiveness Conflict Risk

'Uses only shell and config code blocks' is somewhat specific and the 'testing contamination' framing gives it a niche, but it would still overlap with any shell/config or testing skill. Fits anchor 3 (somewhat specific, could overlap) — not 4, since no distinct trigger phrases delineate it from related skills.

3 / 5

Total

9

/

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

pantheon-org/tekhne

Path

crates/skill-validator-rs/tests/golden-corpus/fixtures/testdata/auxiliary-only-skill/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.