What is the 'Kill Test' in the Distill skill?

The Kill Test is a validation process that deletes any information Claude can figure out on its own (like file structures or package versions) to prioritize surprising or counter-intuitive project details.

How does this differ from a standard README.md?

A README is typically for humans; a distilled CLAUDE.md is an 'operating guide' for AI agents, focusing on high-density instructions, non-obvious constraints, and critical 'don't touch' areas.

What is the '3-2-1' compression rule?

It is a quality check requiring the guide to have 3 key invariants, 2 critical architecture insights, and 1 clear starting point in the codebase to ensure maximum utility.

Will this skill overwrite my existing files automatically?

No, the skill follows a pattern where it drafts the distilled content (often to a temporary file) for you to review and refine before it becomes the primary project guide.

Repository Distiller

Name: Repository Distiller
Author: phrazzld

byphrazzld

•

学习与文档

Distills repository knowledge into a high-density, actionable CLAUDE.md onboarding guide.

The Distill skill is designed to optimize project onboarding by transforming repository documentation into a sharp, AI-ready CLAUDE.md file. It uses a rigorous 'Kill Test' to strip away discoverable information—such as file trees or standard tech stacks—that Claude can already see. Instead, it focuses on preserving 'earned by pain' insights, non-obvious invariants, and surprising constraints. This ensures that any contributor or AI agent can understand the core architecture and avoid common pitfalls within minutes, maximizing the signal-to-noise ratio of your project's instructions.

主要功能

01Standardizes documentation into a lean, actionable target shape

02Preserves high-signal tribal knowledge and 'load-bearing' code warnings

03Synthesizes info from READMEs, ADRs, and config files into a single source of truth

045 GitHub stars

05Automated 'Kill Test' to remove redundant, discoverable information

06Applies the 3-2-1 compression rule for maximum clarity and brevity

使用场景

01Cleaning up bloated project documentation to reduce context window usage

02Generating an AI-optimized onboarding guide for complex or legacy repositories

03Standardizing operational guidelines and 'footgun' warnings across team projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add phrazzld/claude-config distill

For use in Claude.ai and ChatGPT

Download Skill