demo-skill

A tiny skill used by the skillloadmode example.

Quality

48%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./examples/skillloadmode/skills/demo-skill/SKILL.md

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 lean, well-organized demo that states its purpose and a clear load-then-run sequence without any token waste. Its only real weakness is actionability: it never shows what a skill_load call or a skill_run command actually looks like. One short example invocation would lift it without hurting conciseness.

Dimension	Reasoning	Score
Conciseness	The body is four short lines with no padding and no explanation of concepts Claude already knows; every token earns its place.	5 / 5
Actionability	It names the concrete tools `skill_load` and `skill_run` and the isolated-workspace context, but gives no syntax, arguments, or example commands, so the guidance is concrete yet incomplete.	3 / 5
Workflow Clarity	The two-step sequence 'load this skill with skill_load and then run commands with skill_run' is clear and unambiguous for a simple, non-destructive skill, though it is stated in prose with no example command invocation.	4 / 5
Progressive Disclosure	The skill is under 50 lines with no external material needed; the single heading and two short paragraphs are well organized, satisfying the simple-skill exception.	5 / 5
	Total	17 / 20 Passed

Description

17%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 concise but explains the skill's reason for existing rather than what it does or when to use it. It lacks any concrete actions, natural trigger terms, and a 'Use when...' clause. A functional description like 'Demonstrates skill_load and skill_run workflows in an isolated workspace. Use when testing SkillLoadMode behavior.' would address all four dimensions.

Suggestions

State concrete capabilities in the description, e.g. 'Loads a skill via skill_load and runs commands with skill_run inside an isolated workspace' instead of the meta phrase 'A tiny skill'.

Add an explicit trigger clause such as 'Use when testing skill_load / SkillLoadMode behavior' so completeness is not capped and users have natural keywords to invoke it.

Include a distinguishing domain term (e.g. 'SkillLoadMode demo') so the description cannot be confused with other skills.

Dimension	Reasoning	Score
Specificity	The description "A tiny skill used by the skillloadmode example" names a specific context (the skillloadmode example) but states no concrete actions or capabilities whatsoever; it sits between the entirely-vague anchor 1 and the domain-with-actions anchors.	2 / 5
Completeness	"A tiny skill" is a vague statement of what and there is no 'when to use' guidance at all, matching the anchor for vague 'what' with no 'when'.	2 / 5
Trigger Term Quality	The only terms present are technical jargon ("skill", "skillloadmode") that no user would naturally say when needing this skill; there are no natural trigger keywords.	1 / 5
Distinctiveness Conflict Risk	The description is a meta-statement about the skill's purpose with no capability signal, so it fails to distinguish itself from other skills and carries high overlap risk, though its reference to a specific example keeps it above the entirely-generic anchor.	2 / 5
	Total	7 / 20 Passed

Validation

100%

Warnings & errors only

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: trpc-group/trpc-agent-go
Path: examples/skillloadmode/skills/demo-skill/SKILL.md
Commit: 9bb1c42

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.