skill-name
Clear description of what this skill does and when to use it
Overall
score
27%
Does it follow best practices?
Validation for skill structure
Activation
0%This is placeholder/template text rather than an actual skill description. It contains no concrete capabilities, no trigger terms, and no guidance on when to use the skill. It fails all evaluation criteria as it provides zero useful information for skill selection.
Suggestions
Replace the placeholder text with specific actions the skill performs (e.g., 'Generates reports', 'Parses log files', 'Creates database queries')
Add a 'Use when...' clause with concrete trigger terms that users would naturally say when they need this skill
Include domain-specific keywords and file types/formats the skill handles to distinguish it from other skills
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions whatsoever - 'Clear description of what this skill does' is meta-language about what a description should contain, not actual capabilities. | 1 / 3 |
Completeness | This is placeholder text that answers neither 'what does this do' nor 'when should Claude use it' - it merely describes what a good description should contain without providing actual content. | 1 / 3 |
Trigger Term Quality | Contains no natural keywords a user would say when needing a skill. Terms like 'skill', 'description', and 'when to use it' are generic meta-terms, not domain-specific triggers. | 1 / 3 |
Distinctiveness Conflict Risk | Completely generic placeholder text that provides no distinguishing characteristics; would be indistinguishable from any other skill with similar boilerplate. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
20%This is a skill template, not an actual skill. It contains placeholder content throughout with no real actionable guidance, executable code, or specific instructions. While it demonstrates reasonable structural organization, the meta-documentation about creating skills and frontmatter guides should not be in a skill body and significantly reduces its utility.
Suggestions
Replace all placeholder content with actual, executable code examples specific to a real task
Remove the 'Frontmatter Guide' and 'Creating Your Skill' sections - these are meta-documentation that belongs in a separate contributor guide, not in a skill body
Add concrete, specific examples with real inputs and expected outputs instead of generic 'input' and 'Expected output here' placeholders
Define what this skill actually does - currently 'Skill Name' and 'Brief description' are placeholders with no real purpose
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This is a template with placeholder content, not an actual skill. It contains extensive meta-documentation about how to create skills, frontmatter guides, and generic placeholder text that provides no actionable value for any specific task. | 1 / 3 |
Actionability | All code examples are placeholders (e.g., 'script.py "input"', 'command.py --option value') with no real executable content. The troubleshooting section has empty 'Step 1, Step 2' placeholders. Nothing is copy-paste ready for any actual task. | 1 / 3 |
Workflow Clarity | The template does demonstrate a reasonable structure for workflows with numbered steps and sections, but since all content is placeholder, there are no actual validation checkpoints or feedback loops for any real process. | 2 / 3 |
Progressive Disclosure | The structure shows appropriate sectioning and references to external files (examples/, scripts/), but the template nature means navigation points to non-existent content. The frontmatter guide section at the end is misplaced meta-content that shouldn't be in a skill body. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
75%Validation — 12 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
description_trigger_hint | Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...') | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 12 / 16 Passed | |
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.