CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rules-auditor

Audit Claude Code rules and CLAUDE.md/AGENTS.md files for staleness, quality, and drift. Use when asked to audit rules, check stale CLAUDE.md, check stale AGENTS.md, review rules freshness, assess rules quality, improve my rules, find dead globs in rules, check if rules are up to date, review progressive disclosure setup, find contradictory rules, or optimize Claude Code memory files.

2.04x
Quality

86%

Does it follow best practices?

Impact

100%

2.04x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 instruction-only skill with executable discovery and verification commands, clear sequencing, and exemplary reference navigation. Its weaknesses are repetition in the body (the AGENTS.md note and trigger list) and direction-level guidance for the more advanced verification steps.

Suggestions

State the AGENTS.md equivalence once (in the Overview) and drop the repeated Note in Discovery step 2; similarly remove the 'Use this skill when asked to' list that duplicates the frontmatter description.

Add concrete grep/extraction commands for Steps 3-5 (code pattern verification, convention drift, structural verification), mirroring the style of Steps 1-2.

Replace the undefined $glob_pattern in the dead-glob snippet with a working loop that reads paths: globs from each rule file, and define what to do when a finding is ambiguous (e.g., re-verify against git history) to add a feedback loop.

DimensionReasoningScore

Conciseness

Mostly efficient with purposeful code blocks, but there is repeated padding: the AGENTS.md explainer appears twice nearly verbatim ("AGENTS.md is a third-party alternative that uses the exact same rules..." in the Overview and again as a Note in Discovery step 2), and the "Use this skill when asked to" bullet list duplicates the frontmatter description. Fits 'mostly efficient but could be tightened' better than 'minor instances' at 4, since two sections are pure repetition.

3 / 5

Actionability

Discovery, dead-glob detection, and reference verification give concrete executable bash commands, and freshness scoring uses concrete thresholds (60+ days, <50% convention adherence). Not 5 because Steps 3-5 (code pattern verification, convention drift, structural verification) are direction-level with no commands or extraction snippets, and the glob-test snippet uses an undefined $glob_pattern variable; not 3 because the core workflow steps are executable rather than pseudocode.

4 / 5

Workflow Clarity

A clear two-phase sequence (Discovery 1-4, Audit Steps 1-7) with an explicit freshness-scoring table acting as validation criteria and a defined report format with priority ranking. Not 5 because the audit steps lack feedback loops (e.g., what to re-check after a flagged rule is inspected, or how to resolve ambiguous drift findings); not 3 because checkpoints and evaluation criteria are explicit, not implicit.

4 / 5

Progressive Disclosure

The body is a genuine overview: a Reference Navigation table maps four topics to the four real files in references/ (all verified to exist, each one level deep with its own table of contents), plus a CI section that signals the same guide. Matches the clear-overview, well-signaled, one-level-deep anchor; the only quibble is the /install-rules-audit command reference with no commands/ directory in the bundle, which is a bundle-completeness issue rather than a navigation one.

5 / 5

Total

16

/

20

Passed

Description

95%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: explicit what and when, unusually thorough natural-language trigger coverage, and a well-defined niche. The only improvement space is making the capability statement itself enumerate distinct actions rather than one verb with audit dimensions.

Suggestions

Consider listing the distinct audit operations (e.g., 'detect dead globs, verify referenced files, score freshness') in the capability sentence itself rather than only in the trigger clause.

DimensionReasoningScore

Specificity

"Audit Claude Code rules and CLAUDE.md/AGENTS.md files for staleness, quality, and drift" names the domain and concrete audit dimensions, and the trigger clause adds operations like "find dead globs in rules" and "find contradictory rules", giving several specific actions with minor gaps. Not 5 because the core 'what' is a single audit verb with three qualities rather than a list of multiple distinct concrete operations; not 3 because coverage clearly exceeds 1-2 actions.

4 / 5

Completeness

Both questions are explicitly answered: what ("Audit ... for staleness, quality, and drift") and when ("Use when asked to audit rules, check stale CLAUDE.md, ...") with many concrete trigger phrases. Matches the anchor that clearly and explicitly answers both; the explicit 'Use when' clause rules out any cap.

5 / 5

Trigger Term Quality

The trigger clause covers a comprehensive set of natural user phrasings — "audit rules", "check stale CLAUDE.md", "improve my rules", "check if rules are up to date", "review progressive disclosure setup", "find contradictory rules" — including synonyms (CLAUDE.md, AGENTS.md, memory files, rules). Matches the comprehensive-coverage-with-synonyms anchor; nothing natural appears missing for this domain.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (Claude Code memory/rules files) with distinct triggers like "find dead globs in rules" and "review rules freshness" that no general-purpose skill would claim. Minimal conflict risk; matches the clear-niche anchor rather than the minor-overlap anchor at 4.

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

seanGSISG/claude-depot

Path

plugins/rules-auditor/skills/rules-auditor/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.