demo-profile
Demo skill for the SkillToolProfile example.
46
Quality
32%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./examples/skilltoolprofile/skills/demo-profile/SKILL.mdQuality
Discovery
0%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 with no functional value for skill selection. It provides zero information about capabilities, use cases, or trigger conditions. Claude would have no basis for knowing when to select this skill from a pool of available options.
Suggestions
Replace the placeholder text with a description of what the skill actually does, listing 2-3 specific concrete actions (e.g., 'Generates reports, validates data, creates summaries').
Add an explicit 'Use when...' clause that specifies trigger conditions and natural keywords users would say when they need this skill.
Include domain-specific terms and file types/formats if applicable to make the skill distinguishable from others.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions whatsoever - 'Demo skill for the SkillToolProfile example' is entirely abstract and provides 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'. There is no functional description and no trigger guidance whatsoever. | 1 / 3 |
Trigger Term Quality | Contains no natural keywords a user would say. 'Demo skill' and 'SkillToolProfile example' are internal/technical terms that no user would naturally use when seeking help. | 1 / 3 |
Distinctiveness Conflict Risk | Extremely generic - 'Demo skill' could apply to anything and provides no distinguishing characteristics that would help Claude select it appropriately over other skills. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a minimal demo skill that achieves conciseness but sacrifices some actionability and clarity. The single command is concrete, but the distinction between 'full mode' and 'knowledge-only mode' is unclear, and referenced documentation is not linked. As a demo skill, brevity is appropriate, but it could better serve its educational purpose with slightly more context.
Suggestions
Clarify what 'knowledge-only mode' means and when Claude should use it versus full mode
Add a brief note about what the script does and what output to expect (e.g., 'Creates a profile file at the specified path')
Link to the referenced 'docs' or remove the reference if no docs exist
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is extremely brief and doesn't explain concepts Claude already knows. Every line serves a purpose - stating the skill's demo nature and providing the single command. | 3 / 3 |
Actionability | Provides a concrete executable command, but lacks context on what the command does, what output to expect, or how to verify success. The guidance for 'knowledge-only mode' is vague. | 2 / 3 |
Workflow Clarity | For a simple single-task skill, the workflow is present but incomplete. It mentions two modes (full vs knowledge-only) without clearly explaining when to use each or what 'use the docs for reasoning' means in practice. | 2 / 3 |
Progressive Disclosure | The skill is appropriately brief for its purpose, but references 'docs' without linking to them. For a demo skill under 50 lines this is acceptable, but the missing reference to actual documentation prevents a score of 3. | 2 / 3 |
Total | 9 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- trpc-group/trpc-agent-go
- Commit
50ef2f3
- 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.