CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-name

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

1.53x
Quality

3%

Does it follow best practices?

Impact

98%

1.53x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./template/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
resciencelab/opc-skills
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.