template-skill

Replace with description of the skill and when Claude should use it.

2.27x

Quality

Does it follow best practices?

Impact

100%

2.27x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude/skills/template-skill/SKILL.md

Quality

Content

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 since there are no instructions, examples, code, or references of any kind. It needs to be written from scratch.

Suggestions

Add concrete, actionable instructions with specific steps or executable code examples for the intended task.

Define the skill's purpose and provide a clear workflow with validation checkpoints if multi-step operations are involved.

Include a concise quick-start section and, if the skill is complex, reference supporting files for advanced details.

Replace the placeholder heading with actual content that teaches Claude how to perform the specific task described in the skill's metadata.

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 essentially a blank template placeholder.	1 / 3
Workflow Clarity	No workflow, steps, or processes are defined. There is nothing to follow or execute.	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

Description

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. The description needs to be entirely replaced with actual content.

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 others.

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.	1 / 3
	Total	4 / 12 Passed

Validation

100%

Warnings & errors only

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.

Repository: einverne/dotfiles
Commit: b1b2fe0

Reviewed: 4 months ago

Table of Contents

Discovery Implementation Validation

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.