Clear description of what this skill does and when to use it. Include trigger keywords and contexts inline, e.g. "Use when user wants to X, Y, or Z."
38
3%
Does it follow best practices?
Impact
98%
1.53xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./template/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 is a boilerplate template placeholder, not an actual skill description. It contains no concrete actions, no real trigger terms, no domain specificity, and no guidance for when Claude should select this skill. It fails on every dimension.
Suggestions
Replace the placeholder entirely with a description of the skill's actual capabilities, listing specific concrete actions (e.g., 'Extract text from PDFs, fill forms, merge documents').
Add an explicit 'Use when...' clause with natural trigger terms that users would actually say when they need this skill.
Identify the skill's unique domain niche and include distinguishing keywords to prevent conflicts with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | This is a template/placeholder description with no concrete actions whatsoever. It describes no actual capabilities—just instructions for how to write a description. | 1 / 3 |
Completeness | Neither 'what does this do' nor 'when should Claude use it' is answered. The text is meta-instructions about writing a description, not an actual description. | 1 / 3 |
Trigger Term Quality | Contains no natural keywords a user would say. The only 'trigger' terms are generic placeholders ('X, Y, or Z') that provide zero matching value. | 1 / 3 |
Distinctiveness Conflict Risk | Completely generic placeholder text that is indistinguishable from any other skill. It would either match everything or nothing. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
7%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a blank skill template with placeholder content throughout, not an actual skill. It contains no real instructions, no executable code, and no domain-specific guidance. While the structural organization is reasonable as a template, it fails on every substantive dimension because it teaches Claude nothing actionable.
Suggestions
Replace all placeholder content with actual, domain-specific instructions, commands, and examples that are executable and copy-paste ready.
Remove the meta-sections ('Frontmatter Guide', 'Creating Your Skill') which are instructions for skill authors, not content that helps Claude perform a task.
Add concrete validation steps and feedback loops to any multi-step workflows, especially in the Quick Start and Commands sections.
Eliminate generic placeholder text ('Important note 1', 'Description of the problem') and replace with real content or remove the sections entirely.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This is a template/boilerplate file with placeholder content throughout. It explains meta-instructions like 'Creating Your Skill' and 'Frontmatter Guide' which are not actionable skill content. Nearly every section contains placeholder text ('Description of what this script does', 'Expected output here', 'Important note 1') that wastes tokens without providing real guidance. | 1 / 3 |
Actionability | No concrete, executable guidance exists anywhere in this content. Every command, script name, and example is a placeholder (e.g., 'python3 scripts/command.py --option value', 'param1', 'Expected output here'). Nothing is copy-paste ready or specific to any real task. | 1 / 3 |
Workflow Clarity | While there is a numbered sequence in the 'Creating Your Skill' section, it describes how to create a skill from the template rather than an actual workflow. The troubleshooting section has placeholder steps. No validation checkpoints or feedback loops exist for any process. | 1 / 3 |
Progressive Disclosure | The template does demonstrate reasonable structural organization with clear section headers (Quick Start, Usage Examples, Commands, Troubleshooting, References) and references to external directories like 'examples/'. However, the structure is generic scaffolding rather than purposefully organized content, and the inline Frontmatter Guide section is misplaced meta-content. | 2 / 3 |
Total | 5 / 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.
b18c6e6
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.