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

48

1.53x
Quality

21%

Does it follow best practices?

Impact

98%

1.53x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./template/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 an authoring template rather than skill documentation: every section contains placeholder text, no executable commands, and references to scripts and examples directories that are absent from the bundle. Structure and section organization are sound, which keeps mid-level scores, but as a usable skill it provides no actionable guidance. It must be populated with real commands, outputs, and workflow steps.

Suggestions

Replace all placeholder text ("Description of the problem", "Step 1", "Expected output here") with real commands, actual outputs, and concrete troubleshooting symptoms/solutions.

Create the referenced `scripts/` and `examples/` files (or remove the references), so navigation links resolve to real bundle content.

Add explicit validation steps to any multi-step workflow (e.g. a verify command after each transformation) rather than the implicit "Test with your agent".

DimensionReasoningScore

Conciseness

The body spends most of its lines on scaffold that teaches nothing: a Frontmatter Guide table explaining fields Claude already understands, "Creating Your Skill" steps, and placeholder sections like "(if applicable)" and "Important note 1". This matches anchor 2 ("noticeably verbose; several unnecessary... padded sections"); it is not anchor 1 only because there is noconcept-explanation padding, and not anchor 3 because almost no line conveys real skill content.

2 / 5

Actionability

Command lines exist in the right shape ("python3 scripts/script1.py \"param1\" --option value") but are template placeholders pointing to scripts that do not exist, with outputs like "Expected output here". This is pseudocode-level guidance matching anchor 3 ("pseudocode instead of executable code; missing key details"); it exceeds anchor 2 because the command structure and options are concretely formed, but falls short of anchor 4 because nothing is executable.

3 / 5

Workflow Clarity

The "Creating Your Skill" section lists a coherent sequence (copy template → update frontmatter → add scripts → test with agent), giving a clear sequence, but validation checkpoints are absent and "Test with your agent" is an implicit, unspecified check. This matches anchor 3 ("steps listed but validation gaps; checkpoints missing or implicit"); anchor 4 requires explicit verification steps.

3 / 5

Progressive Disclosure

Sections are well organized with headers, and references are one level deep ("See `examples/` directory"), but the referenced files and directories do not exist in the bundle, so navigation is broken, and much of the inline scaffold content is not real overview material. This matches anchor 3 ("some structure but could be better organized; references present but not clearly signaled"); it does not reach anchor 4 because key references point to nonexistent files.

3 / 5

Total

11

/

20

Passed

Description

0%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 field is unfilled template placeholder text rather than a description of an actual skill. It fails all four dimensions at the floor because it conveys no domain, capability, trigger, or use context. It needs to be rewritten once the skill's actual purpose is defined.

Suggestions

Replace the placeholder with a concrete capability statement in third person, e.g. "Extracts text and tables from PDF files, fills forms, merges documents".

Append an explicit trigger clause naming natural user phrases, e.g. "Use when the user mentions PDFs, forms, or document extraction".

Include domain-specific terms and file extensions (e.g. ".pdf", "forms") to distinguish this skill from generic document-processing skills.

DimensionReasoningScore

Specificity

"Clear description of what this skill does and when to use it" names no domain and no concrete actions — it is template instruction text, not a capability statement. It matches anchor 1 ("Entirely vague; no concrete actions") and cannot reach anchor 2, which requires at least naming a domain.

1 / 5

Completeness

Neither 'what' nor 'when' is answered: the text describes what a description should contain rather than what the skill does or when to use it. It is missing both, matching anchor 1; anchor 2 requires at least a vague 'what' or a 'when', neither of which is present.

1 / 5

Trigger Term Quality

No natural keywords exist; the only trigger-shaped text is the placeholder "e.g. \"Use when user wants to X, Y, or Z.\"", which is meta-guidance, not a term a user would say. This is anchor 1 ("No natural keywords; only technical jargon or entirely generic language").

1 / 5

Distinctiveness Conflict Risk

The text is entirely generic template language with zero domain signal, so it is indistinguishable from (and would conflict with) virtually any skill. Anchor 1 fits; anchor 2 requires at least a broad domain like "documents".

1 / 5

Total

4

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

15

/

16

Passed

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.