Replace with description of the skill and when Claude should use it.
36
0%
Does it follow best practices?
Impact
100%
2.27xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./claude/skills/template-skill/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 description that provides zero useful information about the skill's capabilities or when it should be used. It would be completely non-functional for skill selection, as Claude would have no basis to choose this skill for any task. Every dimension scores at the minimum level.
Suggestions
Replace the entire placeholder text with a concrete description of what the skill does, listing specific 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.
Include domain-specific keywords and file types/formats to make the skill clearly distinguishable from other available skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | This is a placeholder/template description with no concrete actions described. 'Replace with description of the skill' provides zero information about what the skill does. | 1 / 3 |
Completeness | Neither 'what does this do' nor 'when should Claude use it' is answered. The placeholder text mentions both concepts but provides no actual content for either. | 1 / 3 |
Trigger Term Quality | Contains no natural keywords whatsoever. The text is entirely boilerplate template language with no domain-specific or user-facing trigger terms. | 1 / 3 |
Distinctiveness Conflict Risk | A generic placeholder description is maximally conflicting — it provides no distinguishing information that would differentiate this skill from any other skill. | 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 skill contains no actual content — only a placeholder heading. It provides zero value as a skill file and cannot guide Claude in performing any task. Every dimension scores at the minimum because there is nothing to evaluate.
Suggestions
Add actual instructions with concrete, executable code examples or specific step-by-step guidance for the intended task.
Define the skill's purpose clearly in the first section and provide a quick-start workflow.
Include validation or verification steps if the skill involves multi-step or destructive operations.
If the skill is complex, organize content with clear sections and reference supporting files for advanced details.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill content is completely empty — it contains only a heading ('# Insert instructions below') with no actual instructions, code, or guidance. There is no content to evaluate for token efficiency, but the placeholder text provides zero value. | 1 / 3 |
Actionability | There is no actionable content whatsoever — no code, no commands, no concrete guidance. The skill body is effectively blank. | 1 / 3 |
Workflow Clarity | No workflow, steps, or processes are defined. The content is a placeholder with no sequence or validation steps. | 1 / 3 |
Progressive Disclosure | No structure, no references, no organization. The content is an empty placeholder with no navigation or content hierarchy. | 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.
b1b2fe0
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.