claude-only-skill

A skill restricted to Claude Code only

Quality

23%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/fixtures/sample-plugin/skills/claude-only-skill/SKILL.md

Quality

Content

22%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a placeholder ("Claude-only skill body.") carrying no executable guidance, workflow, or structure. It cannot function as a skill instructions file in its current form.

Suggestions

Replace the placeholder with concrete, executable guidance or code for the skill's actual task.

If the task is multi-step, sequence the steps with explicit validation checkpoints.

Add section headers (e.g. ## Quick start) so the overview is navigable, and move large detail into reference files one level deep.

Dimension	Reasoning	Score
Conciseness	The single line "Claude-only skill body." has no padding or over-explanation, but it is vacuous rather than lean, so it sits at the midpoint rather than earning the top conciseness anchor.	3 / 5
Actionability	The body provides no concrete code, commands, or specific guidance — only a placeholder label — matching the entirely-vague/no-instructions anchor.	1 / 5
Workflow Clarity	There are no steps, sequence, or even a single unambiguous action; the body is a placeholder, matching the missing/incoherent-steps anchor (the simple-skill exception does not apply because no action is stated).	1 / 5
Progressive Disclosure	With no bundle files and no sections there is no monolithic wall or nested referencing to penalize, but there is also no real organization, placing it at the midpoint rather than the well-structured anchors.	3 / 5
	Total	8 / 20 Passed

Description

25%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a near-placeholder: it states a platform constraint rather than a capability, omits any concrete actions, and provides no trigger guidance. It is distinguishable only by platform, not by function.

Suggestions

Replace the constraint statement with concrete capabilities, e.g. "Extracts text and tables from PDF files, fills forms, merges documents."

Add an explicit "Use when..." clause naming natural trigger phrases users would actually say.

Include relevant synonyms and file extensions (e.g. PDFs, .pdf, forms) to improve trigger-term coverage and distinctiveness.

Dimension	Reasoning	Score
Specificity	The phrase "A skill restricted to Claude Code only" names a platform domain but describes zero concrete actions, sitting between the entirely-vague anchor (1) and the domain-named-with-minimal-actions anchor (3).	2 / 5
Completeness	It offers only a vague "what" (a platform restriction, not a capability) and no "when"/"Use when..." clause, matching the anchor for a vague what with no when; the missing trigger guidance also caps completeness at 3.	2 / 5
Trigger Term Quality	"Claude Code" is the only keyword and it is not a natural trigger phrase a user would say when needing this skill, matching the anchor for one generic keyword missing the natural phrases.	2 / 5
Distinctiveness Conflict Risk	Many skills could be "restricted to Claude Code only," so the description is very broad with high overlap risk, matching the anchor for high conflict risk with many similar skills.	2 / 5
	Total	8 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: EveryInc/compound-engineering-plugin
Path: tests/fixtures/sample-plugin/skills/claude-only-skill/SKILL.md
Commit: 8a6e0a2

Reviewed: 3 days 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.