demo-profile

Demo skill for the SkillToolProfile example.

Quality

58%

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/skilltoolprofile/skills/demo-profile/SKILL.md

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 exemplary lean, simple skill: a clear purpose, one concrete runnable command backed by a real script, and clean structure. The only minor gap is limited coverage of usage variants.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes competence: a one-line purpose and a single concrete command with no padding, matching 'Lean and efficient; every token earns its place'.	5 / 5
Actionability	It provides a concrete, executable command 'sh scripts/write_profile.sh out/profile.txt' referencing a real script, but offers only one example with no coverage of variants, fitting 'concrete code or commands with minor gaps'.	4 / 5
Workflow Clarity	This is a simple single-action skill with an unambiguous action and no destructive or batch operation requiring validation, so the simple-skill exception allows the top score.	5 / 5
Progressive Disclosure	Under 50 lines with no need for external references, well-organized into a purpose statement and a runnable command referencing the real scripts/write_profile.sh, satisfying the simple-skill criterion.	5 / 5
	Total	19 / 20 Passed

Description

25%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 minimal placeholder: it identifies the skill as a demo but states no concrete actions, no trigger terms, and no 'when to use' guidance. It reads as scaffolding rather than a functional skill description.

Suggestions

Add concrete actions (e.g., 'Writes a sample profile file') instead of the generic 'Demo skill' framing.

Include a 'Use when...' clause with natural trigger phrases so Claude knows when to invoke it.

Add specific keywords (e.g., 'SkillToolProfile', 'profile demo', 'skill tool profile') to improve trigger-term quality and distinctiveness.

Dimension	Reasoning	Score
Specificity	The phrase 'Demo skill for the SkillToolProfile example' names the domain but offers no concrete actions, matching the anchor that 'Names the domain but actions are minimal or generic'.	2 / 5
Completeness	It gives a vague 'what' (a demo skill) and entirely omits a 'when'/'Use when...' trigger clause, which the guidelines cap at 3; the vagueness places it at the lower anchor.	2 / 5
Trigger Term Quality	It contains only generic phrasing ('Demo skill', 'example') with no natural keywords a user would actually say when needing this skill, fitting 'one or two generic keywords'.	2 / 5
Distinctiveness Conflict Risk	'Demo skill for the SkillToolProfile example' is very broad with no distinct trigger, creating high overlap risk with other demo or tooling skills.	2 / 5
	Total	8 / 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/skilltoolprofile/skills/demo-profile/SKILL.md
Commit: 9f7e561

Reviewed: ~17 hours 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.