demo-skill

A tiny skill used by the skill isolation example.

Quality

11%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./examples/skillisolation/skills/demo-skill/SKILL.md

Quality

Discovery

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is essentially a placeholder that provides no useful information for skill selection. It describes the skill's role in an example rather than its actual capabilities or use cases. Claude would have no basis for knowing when to select this skill from a collection.

Suggestions

Replace the meta-description with actual capability statements describing what the skill does (e.g., 'Performs X action on Y type of input')

Add an explicit 'Use when...' clause with concrete trigger terms that match how users would naturally request this functionality

Include specific keywords, file types, or task domains that distinguish this skill from others

Dimension	Reasoning	Score
Specificity	The description contains no concrete actions whatsoever - 'tiny skill' and 'skill isolation example' are completely abstract and provide no information about what the skill actually does.	1 / 3
Completeness	Fails to answer both 'what does this do' and 'when should Claude use it'. The description only references its role as an example, not its actual purpose or triggers.	1 / 3
Trigger Term Quality	Contains no natural keywords a user would say. 'Skill isolation example' is technical jargon referring to internal implementation rather than user-facing functionality.	1 / 3
Distinctiveness Conflict Risk	Extremely generic - 'tiny skill' could apply to anything. Provides no distinguishing characteristics that would help Claude select it appropriately over other skills.	1 / 3
	Total	4 / 12 Passed

Implementation

22%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a test/stub skill designed to verify skill isolation in a multi-agent system, not a functional skill teaching Claude any capability. It contains no actionable instructions, code, or workflows - only a description of its purpose as a leak detector. As actual skill content, it fails to provide any value.

Suggestions

If this is meant to be a real skill, add concrete instructions or code examples for the task it should teach

Define what action or capability this skill should enable Claude to perform

If this is purely a test artifact, consider whether it should be evaluated as skill content at all

Dimension	Reasoning	Score
Conciseness	The content is brief but provides no actionable value - it's essentially a test stub rather than a real skill, so while not verbose, it doesn't earn its tokens through useful content.	2 / 3
Actionability	Provides no concrete guidance, code, commands, or instructions - it's purely descriptive text about what the skill is for (testing isolation) rather than teaching Claude how to do anything.	1 / 3
Workflow Clarity	No workflow, steps, or process described - the content is a meta-description about skill isolation testing rather than any actionable procedure.	1 / 3
Progressive Disclosure	The content is appropriately brief for what it is, with no unnecessary nesting or references, but it also provides no structure because there's no real content to organize.	2 / 3
	Total	6 / 12 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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: trpc-group/trpc-agent-go
Commit: 50ef2f3

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.