One sentence — what this skill does and when Claude should use it.
20
0%
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 ./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 an unfilled template placeholder, not an actual skill description. It provides no information about what the skill does, when to use it, or any domain-specific trigger terms. It would be entirely non-functional for skill selection.
Suggestions
Replace the placeholder with an actual description that names the specific domain and lists concrete actions (e.g., 'Extract text and tables from PDF files, fill forms, merge documents').
Add an explicit 'Use when...' clause with natural trigger terms that users would actually say when they need this skill.
Include file types, keywords, and common phrasings that distinguish this skill from others in the skill library.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | This is a template placeholder, not an actual description. It contains no concrete actions whatsoever — just meta-instructions about what should be written there. | 1 / 3 |
Completeness | Neither 'what does this do' nor 'when should Claude use it' is answered. The placeholder references both concepts but provides no actual content for either. | 1 / 3 |
Trigger Term Quality | Contains zero natural keywords a user would say. The text is purely instructional boilerplate with no domain-specific or task-specific terms. | 1 / 3 |
Distinctiveness Conflict Risk | Completely generic — this placeholder could apply to any skill and provides no distinguishing information whatsoever. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
0%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an empty template with no actual skill content. It contains only placeholder headings and ellipsis, providing zero actionable guidance, no code examples, no workflow, and no useful information for Claude.
Suggestions
Replace placeholder text with actual instructions describing what the skill does and concrete steps to accomplish it.
Add executable code examples or specific commands that Claude can directly use.
Define a clear workflow with numbered steps and validation checkpoints if the skill involves multi-step processes.
If the skill is complex, add references to supplementary files with clear navigation signals (e.g., 'See [REFERENCE.md](REFERENCE.md) for full API details').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is essentially a blank template with placeholder text ('Skill Title', 'Brief description', '...'). There is no substantive content, yet the placeholders add no value and waste tokens. | 1 / 3 |
Actionability | There is no concrete, executable guidance whatsoever — just placeholder headings and ellipsis. Claude would have no idea what to do with this skill. | 1 / 3 |
Workflow Clarity | No steps, no sequence, no validation checkpoints — the Instructions section is literally '...' with no workflow defined. | 1 / 3 |
Progressive Disclosure | No structure beyond bare placeholder headings. No references, no navigation, no content organization of any kind. | 1 / 3 |
Total | 4 / 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.
6f8671f
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.