CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prose-pass

Judge added comments, JSDoc, changelog entries, and PR bodies on information content and cut what a reader can derive. Use before presenting a diff, committing, or writing a PR body.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 exemplary instruction-only skill: lean, concrete, and sequenced, with a runnable checklist, validation steps, and artifact-specific decision rules backed by short keep/cut examples. The only structural note is that all guidance lives in a single moderately long file with no quick-start/reference split, which is acceptable at this size but leaves minor organization headroom.

DimensionReasoningScore

Conciseness

The body is dense decision rules with short, load-bearing examples; it never explains concepts Claude already knows and assumes competence ("No phrasing is banned; nothing survives on phrasing either"). Every section — the bar, renames, openers, log comments, tests, JSDoc, changelogs, PR bodies, checklist — earns its place.

5 / 5

Actionability

Concrete, executable guidance throughout: named lint rules to check ("ocap/require-jsdoc", "jsdoc/require-param-description", "oxlint.config.ts"), specific opener phrases to inspect ("Ensure", "Handle", "Note that", "Important"), keep/delete code examples for each artifact type, and a 6-step checklist. For an instruction-only skill this fully covers the common cases.

5 / 5

Workflow Clarity

The final Checklist gives a clear ordered sequence (judge → delete → consider rename + re-run lint → re-read survivors → apply to changelogs/PR bodies → return control) with an explicit validation step ("re-run lint", "verify the result still lints") and a review loop (step 4, "this is the pass that gets skipped"). The batch-deletion nature of the pass is covered by lint validation and the JSDoc lint-required carve-out.

5 / 5

Progressive Disclosure

Well-organized single file with clear section headers and one clearly signaled, one-level-deep reference ([docs/contributing/updating-changelogs.md] for format and categories, with the section explicitly scoped to length only). Not 5 because everything lives in one ~178-line SKILL.md with no overview/reference split, which fits anchor 4's 'good structure; minor organization gaps' rather than anchor 5's 'content appropriately split'.

4 / 5

Total

19

/

20

Passed

Description

83%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 that clearly states what the skill does and gives an explicit 'Use before...' trigger clause with three concrete timings. The main gaps are missing synonyms for the artifact terms and mild overlap risk with commit/PR-writing skills on the timing triggers.

Suggestions

Add a synonym or two for the artifact terms (e.g. 'docstrings' or 'release notes') so natural phrasing variations also trigger the skill.

Sharpen the timing trigger to the skill's distinguishing purpose, e.g. 'Use after finishing a code change, before presenting the diff, committing, or writing a PR body' to reduce overlap with commit-message-writing skills.

Optionally name the core decision rule ('cut what a reader can derive from the adjacent code') as the action verb, since that is the skill's most distinctive capability.

DimensionReasoningScore

Specificity

Names four concrete artifacts ("added comments, JSDoc, changelog entries, and PR bodies") and two specific actions ("judge... on information content", "cut what a reader can derive"), matching anchor 4's 'several specific actions; minor gaps'. Not 5 because the verbs are somewhat abstract and don't enumerate the per-artifact judgments the body actually contains.

4 / 5

Completeness

Explicitly answers both: what ("Judge added comments, JSDoc, changelog entries, and PR bodies on information content and cut what a reader can derive") and when ("Use before presenting a diff, committing, or writing a PR body") with three concrete trigger conditions, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Includes natural phrases users and workflows would say — "comments", "JSDoc", "changelog entries", "PR bodies", "diff", "committing" — giving good keyword coverage. Not 5 because synonyms and variations (e.g. "release notes", "docstrings", "documentation comments") are missing.

4 / 5

Distinctiveness Conflict Risk

Has a clear niche — information-content judgment of prose in a diff — that is distinguishable from logic-review skills. Not 5 because the timing triggers "before presenting a diff" and "committing" carry minor overlap risk with closely related commit-message and code-review skills.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

Consensys-Incorporated/ocap-kernel

Path

.claude/skills/prose-pass/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.