CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rule-validate

Validate an implemented React Doctor rule before merge. Use after focused tests pass to review detector correctness, inspect open-source hits, run pull request parity, add regression coverage, prepare a changeset, write pull request copy, or address review findings.

73

Quality

92%

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

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

A tight, high-signal skill body: domain-specific failure modes, exact commands, explicit validation gates, and conditional handling make it directly actionable with genuine feedback loops. The main improvements are giving exact invocations for the project tools (rde-eval, run-parity) and moving the PR copy template into a reference file.

Suggestions

Include the exact command lines for rde-eval and run-parity (or the specific test/typecheck/lint commands) so the guidance is copy-paste executable rather than naming tools Claude must look up.

Move the PR copy markdown template into a references/ file (one level deep) and link to it, keeping SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — the implementation checklist lists domain-specific failure modes ("impossible control-flow path merges", "dynamic properties treated as static names") that Claude would not know, and there is no padding or explanation of known concepts. Not score 4 because no over-explanatory passages remain to trim; every line instructs.

5 / 5

Actionability

Mostly executable guidance: the truffler command is fully specified ("bunx @rayhanadev/truffler \"<helper-name>\" packages --kind function,method,interface,type,constant --limit 20"), "nr changeset" is concrete, and the PR copy template gives an exact structure. Not score 5 because "rde-eval" and "run-parity" are named but never given an invocation, and "Run focused tests, package typecheck, and required lint and format checks" states what to run without the commands. Not score 3 because the concrete commands and template cover the common cases.

4 / 5

Workflow Clarity

Clear sequence (review implementation → run validation → prepare artifacts → handle findings → report) with explicit validation steps and feedback loops: "Fix each implementation bug with a focused regression test", "Add every confirmed false positive to rule tests and the fuzz corpus", "Do not claim parity unless both Vercel Sandbox runs complete", and conditional handling ("Omit the eval table when parity did not run. State the reason instead."). This matches the anchor with checklists and error-recovery handling; nothing is missing for a lower score.

5 / 5

Progressive Disclosure

No bundle files exist and the body is well-organized into six clear sections with no nested references, so navigation is easy. Not score 5 because the ~25-line PR copy template is inlined in the body where a one-level-deep reference file (e.g. a pr-template.md) would keep SKILL.md a pure overview; the skill is also slightly above the ~50-line threshold where sections alone suffice. Not score 3 because the structure is otherwise appropriate and nothing is buried.

4 / 5

Total

18

/

20

Passed

Description

92%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 states what the skill does and when to use it explicitly, enumerates the full set of concrete actions, and occupies a distinct niche with low conflict risk. The only weakness is keyword coverage that leans on project jargon over natural user synonyms.

Suggestions

Add natural-sounding synonyms alongside the project jargon (e.g. "run regression tests", "check PR parity") so users who don't use the exact tool names still trigger the skill.

Consider including the abbreviation "PR" alongside "pull request" to match how users commonly refer to it.

DimensionReasoningScore

Specificity

The description enumerates seven concrete actions — "review detector correctness, inspect open-source hits, run pull request parity, add regression coverage, prepare a changeset, write pull request copy, or address review findings" — giving comprehensive coverage of the skill's scope, matching the anchor for multiple specific concrete actions. Not score 4 because there are no minor coverage gaps; the action list spans the full validation workflow.

5 / 5

Completeness

The 'what' is explicit ("Validate an implemented React Doctor rule before merge") and the 'when' is explicit with concrete trigger phrases ("Use after focused tests pass to review detector correctness... or address review findings"), matching the anchor that requires both clearly answered. Not score 4 because the 'when' clause is fully explicit and enumerates specific triggering situations rather than being merely adequate.

5 / 5

Trigger Term Quality

Good natural keyword coverage for the domain — "validate", "before merge", "regression coverage", "changeset", "pull request copy", "review findings" are phrases a developer would actually say. Not score 5 because common synonyms and variations are missing (e.g. "regression tests", "PR", "parity check"), and terms like "open-source hits" are jargon-shaped rather than user-shaped.

4 / 5

Distinctiveness Conflict Risk

A clear niche — validating an implemented React Doctor rule — with distinct triggers ("pull request parity", "changeset", "detector correctness") that no generic review or testing skill would claim. Minimal conflict risk with other skills. Not score 4 because the domain and trigger terms are highly specific, leaving no meaningful overlap with closely related skills.

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

millionco/react-doctor

Path

.agents/skills/rule-validate/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.