Rules Distill

Scans your installed skills to find principles that show up in multiple places, then suggests promoting them to rule files. The approach is solid: bash scripts collect the raw inventory, then an LLM cross-reads everything and produces verdicts (append, revise, new section, new file). Nothing happens automatically. You get a table of candidates with evidence from specific skills, you approve or skip each one, and it saves a timestamped results file. The batching by theme and cross-batch merge to catch patterns that span categories is thoughtful. Useful for periodic maintenance when your rules feel incomplete relative to what your skills actually assume, or after adding a bunch of new skills that share unstated conventions.

skills.sh installs: 4.3K
GitHub stars: 229.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/everything-claude-code --skill rules-distill --agent claude-code

Installs into .claude/skills of the current project.

Files

Rules Distill

Scan installed skills, extract cross-cutting principles that appear in multiple skills, and distill them into rules — appending to existing rule files, revising outdated content, or creating new rule files.

Applies the "deterministic collection + LLM judgment" principle: scripts collect facts exhaustively, then an LLM cross-reads the full context and produces verdicts.

When to Use

Periodic rules maintenance (monthly or after installing new skills)
After a skill-stocktake reveals patterns that should be rules
When rules feel incomplete relative to the skills being used

How It Works

The rules distillation process follows three phases:

Phase 1: Inventory (Deterministic Collection)

1a. Collect skill inventory

bash ~/.claude/skills/rules-distill/scripts/scan-skills.sh

1b. Collect rules index

bash ~/.claude/skills/rules-distill/scripts/scan-rules.sh

1c. Present to user

Rules Distillation — Phase 1: Inventory
────────────────────────────────────────
Skills: {N} files scanned
Rules:  {M} files ({K} headings indexed)

Proceeding to cross-read analysis...

SKILL.md on GitHub