CtrlK
BlogDocsLog inGet started
Tessl Logo

demo-skill

A tiny skill used by the skillloadmode example.

45

Quality

46%

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 ./examples/skillloadmode/skills/demo-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%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 an appropriately lean, well-structured demo that names the two relevant commands and a clear two-step sequence. Its only weakness is the absence of a full copy-paste invocation example, which leaves actionability just short of perfect.

DimensionReasoningScore

Conciseness

The body is three lean sentences with no padding or explanation of concepts Claude already knows; every token earns its place for a demo skill, matching the 'lean and efficient' anchor.

5 / 5

Actionability

It names the concrete commands `skill_load` and `skill_run` and the isolated-workspace context, giving mostly executable guidance, but stops short of full invocation syntax, leaving a minor gap.

4 / 5

Workflow Clarity

The load-then-run sequence is unambiguous and single-purpose; the simple-skill exception applies and there are no destructive or batch operations requiring validation checkpoints.

5 / 5

Progressive Disclosure

At under 50 lines with no need for external references, the single clear heading and brief body satisfy the simple-skill exception for well-organized structure.

5 / 5

Total

19

/

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-grade sentence that identifies the skill only as a demo fixture, with no capabilities, user-facing triggers, or usage conditions. It fails every dimension because nothing actionable is explicitly stated.

Suggestions

Rewrite the description to state concrete actions, e.g. 'Loads a skill via skill_load and runs commands in an isolated workspace.'

Add a 'Use when...' clause with natural trigger phrases such as 'when testing skill_load behavior' to answer when Claude should invoke it.

Replace the internal jargon 'skillloadmode example' with terms a user would actually say.

DimensionReasoningScore

Specificity

The phrase 'A tiny skill used by the skillloadmode example' names no concrete action whatsoever — it describes the skill's purpose for a demo, not any capability, matching the 'entirely vague; no concrete actions' anchor.

1 / 5

Completeness

It states neither what the skill does (no action verbs or capabilities) nor any 'when to use it' trigger clause, fitting the 'missing both what and when' anchor; the missing 'Use when...' guidance caps completeness well below 3.

1 / 5

Trigger Term Quality

'skillloadmode example' is internal technical jargon with no natural keyword a user would say when needing this skill, matching the 'no natural keywords; only technical jargon' anchor.

1 / 5

Distinctiveness Conflict Risk

Because no functional niche is described, the description cannot be distinguished from other skills by capability and would conflict with virtually anything, matching the 'entirely generic' 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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
trpc-group/trpc-agent-go
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.