rules-distill

Extract cross-cutting principles from installed skills and distill them into rule files.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill rules-distill-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rules-distill
Source: https://github.com/ibytechaos/claude/tree/main/plugins/everything-claude-code/skills/rules-distill
Command: npx skills add https://github.com/ibytechaos/claude --skill rules-distill-ibytechaos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve? As your collection of Claude skills grows, the same principles get repeated across many skills while your central rules files fall out of date. This Skill scans all installed skills, finds principles that appear in two or more of them, and proposes concrete additions or revisions to your rules files — keeping rules complete without manual cross-reading. ## Core Features & Use Cases - Deterministic Inventory: Shell scripts scan global and project-level skills plus existing rule files, producing structured JSON inventories with headings and metadata. - LLM Cross-Read Analysis: Batched subagents compare skill principles against the full rules text and assign verdicts — Append, Revise, New Section, New File, Already Covered, or Too Specific. - User-Controlled Application: Every candidate is presented with evidence, violation risk, and draft text; nothing is written to rules without explicit user approval. - Use Case: After installing a batch of new skills, run a monthly rules maintenance pass to surface recurring principles (e.g., LLM output validation) and promote them into your shared rules with full traceability saved to results.json. ## Quick Start Ask Claude to run the rules-distill skill to scan my installed skills and propose updates to my rules files.

Frequently Asked Questions about rules-distill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract common principles from multiple Claude skills?

Run the rules-distill skill, which scans all installed skills via shell scripts, then uses batched subagents to cross-read them against your rules text. It outputs candidates with evidence, verdicts, and draft text for your approval.

How do I keep Claude rules files up to date after installing new skills?

Run a periodic rules distillation pass. The skill inventories skills and rules, identifies principles appearing in two or more skills that are missing from rules, and proposes Append, Revise, New Section, or New File changes.

Does rules-distill modify my rules files automatically?

No. Every candidate is presented in a summary table with evidence and draft text, and you must explicitly approve, modify, or skip each one. The skill never writes to rules files without user confirmation.

What criteria decide whether a principle becomes a rule?

A principle must appear in at least two skills, be actionable as a do-or-don't behavior, carry a clear violation risk, and not already be covered in existing rules. Single-skill or language-specific knowledge stays in skills.

Where does rules-distill store its analysis results?

Results are saved as results.json in the skill directory, recording the UTC timestamp, counts of skills and rules scanned, and per-candidate details including verdict, target rule file, evidence, and applied or skipped status.