Demo skill for the SkillToolProfile example.
49
Quality
36%
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 that provides no useful information for skill selection. It fails all dimensions by lacking any concrete actions, trigger terms, usage guidance, or distinguishing characteristics. Claude would have no basis for knowing when to select this skill over any other.
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 a 'Use when...' clause with natural trigger terms that users would actually say when they need this skill's functionality.
Define a clear domain or niche to distinguish this skill from others in the skill library.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions whatsoever - 'Demo skill for the SkillToolProfile example' is entirely abstract and doesn't describe 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 'Use when...' clause or equivalent guidance. | 1 / 3 |
Trigger Term Quality | Contains no natural keywords a user would say. 'Demo skill' and 'SkillToolProfile example' are internal/technical terms, not user-facing trigger terms. | 1 / 3 |
Distinctiveness Conflict Risk | Extremely generic - 'Demo skill' provides no distinguishing characteristics. It could conflict with any other skill since it defines no specific domain or purpose. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
72%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 good conciseness and appropriate structure for its limited scope. However, it lacks actionable details about what the command produces, how to verify it worked, and clearer explanation of the two operational modes mentioned.
Suggestions
Add expected output or success criteria for the bash command (e.g., 'Creates profile.txt containing...')
Clarify what 'full mode' vs 'knowledge-only mode' means and how Claude should determine which mode applies
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is minimal and doesn't explain concepts Claude already knows. Every line serves a purpose - describing the skill's demo nature and providing the single command. | 3 / 3 |
Actionability | Provides a concrete bash command that is executable, but lacks context on what the command does, what output to expect, or how to verify success. The 'knowledge-only mode' guidance is vague. | 2 / 3 |
Workflow Clarity | For a simple single-command skill, the workflow is straightforward, but there's no validation step or indication of expected output. The distinction between 'full mode' and 'knowledge-only mode' is mentioned but not clearly defined. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines with a single purpose (demo), the content is appropriately organized with a clear header and concise sections. No external references are needed for this scope. | 3 / 3 |
Total | 10 / 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.
8763418
Table of Contents
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.