CtrlK
BlogDocsLog inGet started
Tessl Logo

improve-rule

Use when reviewing or improving a Front-End Checklist rule MDX file to raise its quality score, fix stub prompts, add missing fields, or enrich content with real code examples.

65

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/improve-rule/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-structured, project-specific body with concrete commands, explicit validation checkpoints, and excellent use of a single one-level-deep reference file. Remaining gaps are unnamed repo resources, no inline good-prompt example, and an implicit re-score feedback loop.

Suggestions

Name the actual file path or command for the 'repo browser policy' and 'package-backed compatibility data' referenced in the Check section so agents can locate them without guessing.

Include one inline example of a good check or fix prompt (the scoring rubric already contains one) so agents have a model to imitate without opening the reference.

Add an explicit final step to re-run 'pnpm score:rules' and 'pnpm validate:rule-structure' after fixes to confirm the score and structure pass.

DimensionReasoningScore

Conciseness

The body is lean and entirely project-specific (scorer commands, stub patterns, section ordering) with no explanation of concepts Claude already knows. It fits 4 rather than 5 because a few tokens could be trimmed — the 'Explain' section's rationale ('A rule without code examples is hard to learn from') and the closing 'High-quality rules become high-quality skills' sentence add little actionable value.

4 / 5

Actionability

Concrete copy-paste commands are provided ('pnpm score:rules packages/content/rules/en/{category}/{slug}.mdx', 'pnpm validate:rule-structure ...') plus exact stub strings to grep for and a precise heading order. It matches 4 (mostly executable, minor gaps) rather than 5 because 'Use the repo browser policy plus package-backed compatibility data' names no file path, and no inline example of a well-written check/fix prompt is shown.

4 / 5

Workflow Clarity

There is a clear sequence — run the scorer and validator, identify failing dimensions, apply prioritized Fix steps 1–8, then verify via the Code Review checklist with explicit validation commands. It sits at 4 rather than 5 because the feedback loop of re-running the scorer after fixes is only implied by the review checklist, not stated as an explicit step; it is clearly above 3 since validation checkpoints are explicit throughout.

4 / 5

Progressive Disclosure

The body is a clean overview that summarizes the scoring dimensions in a table and delegates the full specification to 'references/scoring-rubric.md', which exists in the bundle, is one level deep, and is clearly signaled twice. This matches the 5 anchor — content is appropriately split with nothing inline that belongs in a separate file.

5 / 5

Total

17

/

20

Passed

Description

78%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 with an explicit 'Use when' trigger, a named niche domain, and several concrete actions. Its main gaps are merged what/when phrasing and a few missing natural trigger variations.

Suggestions

State the skill's capabilities in third-person imperative voice separately from the trigger clause, e.g. 'Fixes stub prompts, adds missing metadata fields, and enriches rule bodies with ✅/❌ code examples. Use when reviewing or improving a Front-End Checklist rule MDX file.'

Add natural trigger synonyms such as '.mdx', 'rule quality', or 'rule lint' to broaden keyword coverage toward the top anchor.

DimensionReasoningScore

Specificity

The description names the domain ('Front-End Checklist rule MDX file') and lists several concrete actions — 'raise its quality score, fix stub prompts, add missing fields, or enrich content with real code examples'. It fits the 4 anchor (several specific actions, minor gaps) rather than 5 because 'raise its quality score' is a goal rather than a distinct concrete action and coverage omits tasks like structure validation.

4 / 5

Completeness

Both parts are explicit: an explicit 'Use when reviewing or improving a Front-End Checklist rule MDX file' trigger plus the what (fix stub prompts, add missing fields, enrich content with real code examples). It sits at 4 rather than 5 because the what is embedded inside the trigger clause as purposes instead of being stated as the skill's own capabilities, and clearly above 3 since the 'Use when' clause is present.

4 / 5

Trigger Term Quality

Natural phrases a contributor would say are present: 'reviewing or improving', 'rule MDX file', 'quality score', 'stub prompts', 'code examples'. Good keyword coverage matching the 4 anchor; not 5 because common variations such as the '.mdx' extension, 'lint', or 'rubric' are missing.

4 / 5

Distinctiveness Conflict Risk

'Front-End Checklist rule MDX file' is a clear niche trigger with distinct terms, so minimal conflict risk with any other skill. This matches the 5 anchor rather than 4, which only requires 'mostly distinct' scoping.

5 / 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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.