CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-markdown

Review a change to Markdown that is not part of an agent plugin (standalone skills, AGENTS.md and CLAUDE.md, READMEs, and documentation) for whether it is true of the repository, whether an agent or reader following it acts correctly, and whether it meets the repository's own rules for that content. Use as one lens in a code review run.

1.08x
Quality

94%

Does it follow best practices?

Impact

98%

1.08x

Average score across 18 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is tessl/code-review

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

An efficient, tightly written review-lens skill: every sentence is a real decision rule, the method is concrete (trace names against the repo, follow instructions in order, note the first failure point), and the reporting format is prescribed. The only minor gap is that the method's sequence is embedded in prose rather than enumerated with an explicit checkpoint, keeping workflow clarity at 4.

DimensionReasoningScore

Conciseness

Dense, unpadded policy prose with no explanation of concepts Claude already knows (no 'what Markdown is', no general review theory). Every sentence carries a decision rule, e.g. 'A guard or answer stated elsewhere in the same document, or in a file it points to, counts.' Not 4: there is no over-explanation that could be trimmed without losing a real rule.

5 / 5

Actionability

Concrete method: 'Read the AGENTS.md or CLAUDE.md chain governing the changed files, from the repository root down', 'Trace each concrete thing the changed text names against the repository', 'follow it as the agent would, in order ... and note the first point where it would act wrongly'. Reporting prescribes an exact output format ('Name the file and quote the statement, then what is true or what a reader does instead'). Per the scoring notes, absence of code in an instruction-only skill is not penalized when guidance is this specific.

5 / 5

Workflow Clarity

Sections Scope → Method → Threshold → Reporting form a coherent sequence, and the method's implicit order (read standing rules → trace each name → simulate following the instruction) is discernible. Not 5: the steps are prose rather than an explicitly ordered list and no validation checkpoint is spelled out beyond the review itself. Not 3: the sequence is clear, the report format is defined, and as a read-only review lens it involves no destructive or batch operations requiring feedback loops.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed: the ~60-line body is fully self-contained, organized into well-labeled sections (Scope, Method, Threshold, Reporting), and contains no external references at all. Per the guidelines, a compact skill with no need for external references scores 5 on well-organized sections alone. Not 4: no content here belongs in a separate file.

5 / 5

Total

19

/

20

Passed

Description

91%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.

A strong description: it names three concrete review actions, lists the exact content types in scope, uses natural trigger terms including filenames, and explicitly excludes the plugin lens to avoid conflicts. The only weakness is that the when-clause states the mode of use ('as one lens in a code review run') rather than a sharper trigger condition.

DimensionReasoningScore

Specificity

Quotes: 'for whether it is true of the repository, whether an agent or reader following it acts correctly, and whether it meets the repository's own rules for that content' — three concrete review actions, plus explicitly named targets ('standalone skills, AGENTS.md and CLAUDE.md, READMEs, and documentation') and an explicit exclusion. This is multiple specific concrete actions with comprehensive coverage for its scope; not 4, which requires minor gaps — none are present.

5 / 5

Completeness

The 'what' is fully explicit (truth, followability, repository rules), and 'Use as one lens in a code review run' is an explicit when-clause, so this is above 3. Not 5: the when states the mode of use rather than a concrete trigger condition (e.g., when a code review includes changes to .md files), so it could be more explicit.

4 / 5

Trigger Term Quality

Natural terms a user would say: 'Markdown', 'AGENTS.md and CLAUDE.md', 'READMEs', 'documentation', 'code review'. Includes filenames and domain synonyms covering the full space of markdown-content review requests. Not 4: no commonly used term for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

'a change to Markdown that is not part of an agent plugin' explicitly carves out the neighboring plugin lens, and the niche (non-plugin Markdown content review) is distinct from general code review skills. Clear niche with deliberate conflict avoidance; minimal overlap risk.

5 / 5

Total

19

/

20

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

Validation for skill structure

No warnings or errors.

Repository

tesslio/product-plugins

Path

code-review/skills/review-markdown/SKILL.md

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.