CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

eval-rules

Audit Claude Code instruction rules in .claude/rules/ and ~/.claude/rules/: frontmatter, paths glob validity against real files, symlink load status, and day-to-day usefulness, then update rules with the user. Use for first-time rules setup, rules that apply too often or never, or periodic rules hygiene. Not for Codex .rules command-approval files.

Quality

93%

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

85%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 strong, dense body packed with non-obvious Claude Code rule-loading mechanics and fully executable guidance, sequenced with per-step validation checkpoints and safe edit/delete gates. The main weaknesses are the inlined resolver script (and overall bulk) that belong in bundle files, and an inline version-numbered changelog quote that could be condensed.

Suggestions

Move the Python pattern resolver from Step 3 into a scripts/ bundle file (e.g. scripts/resolve_paths.py) and invoke it by path, keeping SKILL.md as the overview; the Codex section is also a candidate for a short reference file.

Condense the v2.1.284 changelog quote in 'Symlinked rules' to the behavioral rule plus a one-line version note, keeping time-sensitive detail out of the main flow.

The 'Key concepts' table's user-rules caveat and the symlink version note could be merged into a single 'unverified / version-dependent' note to trim near-duplicate hedging.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, tool-specific facts Claude cannot be assumed to know (broken YAML silently turning a rule always-on, the 1,000-pattern / 4 MiB expansion budget, symlink external-import approval semantics), with no padding or explanation of known concepts. It misses 5 because of the verbatim v2.1.284 changelog quote inlined in the Symlinked rules section — time-sensitive version detail that should be trimmed to the behavioral rule — and a few passages that could tighten. Not 3: there is no noticeable verbosity or padded section.

4 / 5

Actionability

Fully executable throughout: a concrete discovery glob, `git ls-files --cached --others --exclude-standard | wc -l`, a complete copy-paste Python resolver script, exact interactive questions with enumerated answer options, and a filled-in report template. Nothing is pseudocode or hand-waved.

5 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced, each with an explicit 'Done when' validation checkpoint; the interactive step gates every edit behind confirmation ("apply it only after confirmation", "Never delete a rule without an explicit 'yes, delete it'"). Despite being a batch-edit skill, validation and feedback loops are present at every stage.

5 / 5

Progressive Disclosure

Sections are well-organized and easy to navigate (When to use, Modes, Key concepts, Scoring Criteria, Execution instructions, Codex, Edge cases), but no bundle files exist and content that should live separately is inlined: the ~35-line Python resolver belongs in a scripts/ file, and at ~215 lines SKILL.md carries the full load on every invocation. Matches anchor 3's 'content that should be separate is inline'; not 2 because structure and navigation are good, not 4 because the script is a clear extraction candidate rather than a minor gap.

3 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: concrete multi-action capability statement, explicit 'Use for' triggers in natural user language, and an explicit out-of-scope boundary against Codex .rules files. Every dimension lands squarely on the top anchor.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "frontmatter, paths glob validity against real files, symlink load status, and day-to-day usefulness, then update rules" — covering the skill comprehensively with no gaps, matching the 5 anchor rather than 4's 'minor gaps in coverage'.

5 / 5

Completeness

Explicitly answers what ("Audit Claude Code instruction rules... frontmatter, paths glob validity... symlink load status... then update rules with the user") and when ("Use for first-time rules setup, rules that apply too often or never, or periodic rules hygiene"), plus a negative scope boundary ("Not for Codex .rules command-approval files").

5 / 5

Trigger Term Quality

"first-time rules setup", "rules that apply too often or never", and "periodic rules hygiene" are natural phrases users would say, supplemented by the .claude/rules/ and ~/.claude/rules/ path keywords; coverage is comprehensive with variations of the common requests. Not 4 — no common phrasing of this need is missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (Claude Code rules auditing) with distinct triggers and an explicit disambiguation from the nearest collision, Codex .rules files; minimal conflict risk with any other skill.

5 / 5

Total

20

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

FlorianBruniaux/claude-code-ultimate-guide

Path

examples/skills/eval-rules/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.