CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

editing-rules-and-skills

Use when editing or creating rules or skills (global or project). Routes to the correct voice and process based on whether the work is correction-driven (encoding a behavioral lesson) or informative (documenting a capability).

Quality

66%

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 ./.claude/skills/editing-rules-and-skills/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-written, lean router with concrete classification criteria, a fallback question, and specific file paths. Its structure is undermined by the fact that every referenced follow-up file (correction-driven.md, informative-capability.md, placement.md) is missing from the bundle, leaving the core workflow unexecutable, and the procedure lacks any post-edit verification checkpoint.

Suggestions

Add the three referenced files (correction-driven.md, informative-capability.md, placement.md) to a references/ directory, or inline their essential guidance — currently every "Load X" instruction points to a nonexistent file.

Make the procedure explicit as ordered steps (classify → load guide → choose placement → edit → confirm), adding a post-edit checkpoint such as re-reading the finished artifact with Josh to confirm the voice and location match the classification.

Extend the concreteness already present in the fallback question and file paths to the routed voices/processes themselves, so the skill remains actionable even before the reference files are opened.

DimensionReasoningScore

Conciseness

Quotes: the whole body is lean — "Before touching anything, identify which kind of work this is", the bulleted "When this skill fires" list, and the four-line "What this skill is NOT" guardrails. It never explains concepts Claude already knows, matching anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed"). Not 5: lines like "classifying wrong is the single biggest way this skill gets misapplied" are editorial padding beyond the instruction needed; not 3: there is no genuine over-explanation, only minor tightening opportunities.

4 / 5

Actionability

Quotes: 'ask Josh in one sentence: "Is this you correcting a behavior, or you wanting me to know about a capability?"', "Editing the flat behavioral rules in claude/CLAUDE.md", "Load correction-driven.md before editing", "Load placement.md for both decisions". The classification procedure, fallback question, and file paths are concrete, but the pivotal "Load X" instructions point to files that do not exist anywhere in the bundle (no references/ directory), so the guidance cannot be executed as written — anchor 3 ("Some concrete guidance but incomplete... missing key details"). Not 4: the gap is broken executable links, not minor details; not 2: the decision procedure given inline is fully concrete.

3 / 5

Workflow Clarity

Quotes: "Before touching anything, identify which kind of work this is", "Load correction-driven.md before editing", "Get either wrong and the artifact pollutes every project, silently stops applying, or lands in the wrong voice". A sequence is discernible (classify → load voice guide → decide placement → edit under guardrails) but it is implicit in section order rather than an explicit procedure, and there are no checkpoints verifying the classification or the finished artifact — anchor 3 ("sequence present but checkpoints missing or implicit"). Not 4: validation is entirely absent rather than a minor gap; not 2: the ordering and the explicit fallback question give a coherent flow.

3 / 5

Progressive Disclosure

Quotes: 'Load **`correction-driven.md`**', 'Load **`informative-capability.md`**', 'Load **`placement.md`**'. The body is written as an ideal one-level router with clearly bolded references, but scored against the actual bundle structure (per the judging guideline), no references/, scripts/, or assets/ directories exist — all three referenced files are missing, so the disclosure structure is nominal and navigation to the detail content is impossible. This lands at anchor 2 (effectively broken/minimal reference structure). Not 3: the references, though clearly signaled, do not resolve to real files; not 1: there is no nested reference chain and the SKILL.md itself is well-organized.

2 / 5

Total

12

/

20

Passed

Description

62%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 solid description with an explicit and well-scoped 'Use when' clause and a distinctive two-category framing of its domain. Its weaknesses are an abstract 'what' (routing is named but the routed voices/processes are not) and thin natural-language trigger coverage.

Suggestions

Add natural trigger phrases a user would actually say, e.g. "add a rule to CLAUDE.md", "create a skill", or "document this so it doesn't happen again", to broaden trigger-term coverage.

Replace the abstract "Routes to the correct voice and process" with the concrete actions performed (classify the work, pick the voice, choose the target file) to raise specificity.

DimensionReasoningScore

Specificity

Quotes: "editing or creating rules or skills", "Routes to the correct voice and process based on whether the work is correction-driven... or informative". It names the domain and the routing/classification action, matching anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive"). Not 4: "routes to the correct voice and process" is abstract — it never names what the routed voices or processes actually are, so action coverage stays thin.

3 / 5

Completeness

Quotes: "Use when editing or creating rules or skills (global or project)" (explicit, specific 'when') and "Routes to the correct voice and process based on whether the work is correction-driven (encoding a behavioral lesson) or informative (documenting a capability)" (a 'what' that defines both categories). Both are present, matching anchor 4 ("Has both 'what' and 'when'"). Not 5: the 'what' is meta — it describes routing rather than the concrete work performed on the rules/skills; not 3: the 'when' is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Quotes: "editing or creating rules or skills", "correction-driven", "informative", "behavioral lesson", "capability". Some relevant keywords exist, but natural user phrasings ("add a rule", "update CLAUDE.md", "document this so it doesn't happen again", "make a skill") are absent — anchor 3 ("Some relevant keywords but missing common variations or synonyms"). Not 4: coverage is partial with no synonyms or file-level trigger terms.

3 / 5

Distinctiveness Conflict Risk

Quotes: "rules or skills (global or project)", "correction-driven", "informative". It occupies a clear niche (editing the rule/skill artifacts themselves) with a distinctive two-category taxonomy, matching anchor 4 ("Mostly distinct; minor overlap risk with closely related skills"). Not 5: "editing or creating... skills" overlaps with generic skill-authoring guidance and sibling meta-skills.

4 / 5

Total

14

/

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

joshmanders/dotfiles

Path

.claude/skills/editing-rules-and-skills/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.