CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rules-distill

Scan skills to extract cross-cutting principles and distill them into rules — append, revise, or create new rule files. Use when the same principle keeps recurring across skills and belongs in a rule file instead.

Quality

91%

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 highly actionable, well-sequenced skill: deterministic collection scripts, a complete reusable subagent prompt, exact output formats, and an explicit user-approval checkpoint for rule modifications. The only weaknesses are minor redundancy (verdict definitions stated twice) and inline content (subagent prompt, example run) that could move to reference files.

DimensionReasoningScore

Conciseness

The body is dense and load-bearing (commands, prompts, JSON schemas, verdict table), but has minor trimmable redundancy: the Verdict Reference table restates the verdict definitions already given in the subagent prompt, and the 'deterministic collection + LLM judgment' principle is stated in both the intro and Design Principles. Fits 4 (efficient, minor over-explanation) rather than 5 (every token earns its place).

4 / 5

Actionability

Fully executable guidance: copy-paste bash commands ("bash ~/.claude/skills/rules-distill/scripts/scan-skills.sh"), a complete ready-to-launch subagent prompt with exact JSON output format, timestamp/Candidate-ID specs, and a worked end-to-end example. Matches the 5 anchor (copy-paste ready, covers common cases); not 4 because there are no significant gaps.

5 / 5

Workflow Clarity

Three phases are clearly sequenced (inventory → cross-read/verdict → user review/execution), and the batch/destructive operation (modifying rule files) is gated by an explicit checkpoint: "Never modify rules automatically. Always require user approval." with approve/modify/skip feedback and a cross-batch merge that re-checks the 2+ skills requirement. Matches the 5 anchor; the destructive-batch cap of 3 does not apply since validation is present.

5 / 5

Progressive Disclosure

Referenced bundle files (scripts/scan-skills.sh, scripts/scan-rules.sh) exist, are one level deep, and are clearly signaled; sections are well organized. However, the ~50-line inline subagent prompt and ~50-line example run are content that could be split into reference files to keep SKILL.md a leaner overview. Fits 4 (good structure, minor organization gaps) rather than 5.

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: third-person, specific, and concise. It states concrete capabilities (scan, extract, distill, append, revise, create) and an explicit 'Use when' trigger clause. Only keyword synonym coverage keeps trigger_term_quality from the top score.

DimensionReasoningScore

Specificity

"Scan skills to extract cross-cutting principles and distill them into rules — append, revise, or create new rule files" lists multiple concrete actions (scan, extract, distill, append, revise, create) with comprehensive coverage of all output modes, matching the 5 anchor. It is not 4 because there are no minor gaps in the action coverage.

5 / 5

Completeness

It explicitly answers both: what ("Scan skills to extract cross-cutting principles and distill them into rules — append, revise, or create new rule files") and when ("Use when the same principle keeps recurring across skills and belongs in a rule file instead") with a concrete trigger phrase, exactly matching the 5 anchor. Not 4 because the 'when' clause is fully explicit, not merely improvable.

5 / 5

Trigger Term Quality

Natural phrases like "the same principle keeps recurring across skills" and "belongs in a rule file" give good keyword coverage, but a few natural user phrasings/synonyms (e.g., "extract principles", "distill rules") are not enumerated. It fits 4 (good coverage, a few terms missing) rather than 5 (synonym- and extension-level comprehensiveness).

4 / 5

Distinctiveness Conflict Risk

"Cross-cutting principles" appearing "in 2+ skills" promoted to rule files is a clear niche with distinct triggers and minimal conflict risk with other skills. Not 4 because no meaningful overlap with closely related skills is identifiable from the description.

5 / 5

Total

19

/

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

affaan-m/ECC

Path

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