Loading source
Pulling the file list, source metadata, and syntax-aware rendering for this listing.
Source from repo
One-time setup that gathers your project's design context and saves it to CLAUDE.md for future sessions.
Files
Skill
Size
Entrypoint
Format
Open file
Syntax-highlighted preview of this file as included in the skill package.
reference/distill.md
1Strip a design to its essence. Remove anything that doesn't earn its place: redundant elements, repeated information, decorative noise, cosmetic complexity.234---56## Assess Current State78Analyze what makes the design feel complex or cluttered:9101. **Identify complexity sources**:11- **Too many elements**: Competing buttons, redundant information, visual clutter12- **Excessive variation**: Too many colors, fonts, sizes, styles without purpose13- **Information overload**: Everything visible at once, no progressive disclosure14- **Visual noise**: Unnecessary borders, shadows, backgrounds, decorations15- **Confusing hierarchy**: Unclear what matters most16- **Feature creep**: Too many options, actions, or paths forward17182. **Find the essence**:19- What's the primary user goal? (There should be ONE)20- What's actually necessary vs nice-to-have?21- What can be removed, hidden, or combined?22- What's the 20% that delivers 80% of value?2324If any of these are unclear from the codebase, STOP and use Codex's structured user-input/question tool when available; if unavailable, ask directly in chat to clarify what you cannot infer.2526**CRITICAL**: Simplicity is not about removing features. It's about removing obstacles between users and their goals. Every element should justify its existence.2728## Plan Simplification2930Create a ruthless editing strategy:3132- **Core purpose**: What's the ONE thing this should accomplish?33- **Essential elements**: What's truly necessary to achieve that purpose?34- **Progressive disclosure**: What can be hidden until needed?35- **Consolidation opportunities**: What can be combined or integrated?3637**IMPORTANT**: Simplification is hard. It requires saying no to good ideas to make room for great execution. Be ruthless.3839## Simplify the Design4041Systematically remove complexity across these dimensions:4243### Information Architecture44- **Reduce scope**: Remove secondary actions, optional features, redundant information45- **Progressive disclosure**: Hide complexity behind clear entry points (accordions, modals, step-through flows)46- **Combine related actions**: Merge similar buttons, consolidate forms, group related content47- **Clear hierarchy**: ONE primary action, few secondary actions, everything else tertiary or hidden48- **Remove redundancy**: If it's said elsewhere, don't repeat it here4950### Visual Simplification51- **Reduce color palette**: Use 1-2 colors plus neutrals, not 5-7 colors52- **Limit typography**: One font family, 3-4 sizes maximum, 2-3 weights53- **Remove decorations**: Eliminate borders, shadows, backgrounds that don't serve hierarchy or function54- **Flatten structure**: Reduce nesting, remove unnecessary containers; never nest cards inside cards55- **Remove unnecessary cards**: Cards aren't needed for basic layout; use spacing and alignment instead56- **Consistent spacing**: Use one spacing scale, remove arbitrary gaps5758### Layout Simplification59- **Linear flow**: Replace complex grids with simple vertical flow where possible60- **Remove sidebars**: Move secondary content inline or hide it61- **Full-width**: Use available space generously instead of complex multi-column layouts62- **Consistent alignment**: Pick left or center, stick with it63- **Generous white space**: Let content breathe, don't pack everything tight6465### Interaction Simplification66- **Reduce choices**: Fewer buttons, fewer options, clearer path forward (paradox of choice is real)67- **Smart defaults**: Make common choices automatic, only ask when necessary68- **Inline actions**: Replace modal flows with inline editing where possible69- **Remove steps**: Can signup be one step instead of three? Can checkout be simplified?70- **Clear CTAs**: ONE obvious next step, not five competing actions7172### Content Simplification73- **Shorter copy**: Cut every sentence in half, then do it again74- **Active voice**: "Save changes" not "Changes will be saved"75- **Remove jargon**: Plain language always wins76- **Scannable structure**: Short paragraphs, bullet points, clear headings77- **Essential information only**: Remove marketing fluff, legalese, hedging78- **Remove redundant copy**: No headers restating intros, no repeated explanations, say it once7980### Code Simplification81- **Remove unused code**: Dead CSS, unused components, orphaned files82- **Flatten component trees**: Reduce nesting depth83- **Consolidate styles**: Merge similar styles, use utilities consistently84- **Reduce variants**: Does that component need 12 variations, or can 3 cover 90% of cases?8586**NEVER**:87- Remove necessary functionality (simplicity ≠ feature-less)88- Sacrifice accessibility for simplicity (clear labels and ARIA still required)89- Make things so simple they're unclear (mystery ≠ minimalism)90- Remove information users need to make decisions91- Eliminate hierarchy completely (some things should stand out)92- Oversimplify complex domains (match complexity to actual task complexity)9394## Verify Simplification9596Ensure simplification improves usability:9798- **Faster task completion**: Can users accomplish goals more quickly?99- **Reduced cognitive load**: Is it easier to understand what to do?100- **Still complete**: Are all necessary features still accessible?101- **Clearer hierarchy**: Is it obvious what matters most?102- **Better performance**: Does simpler design load faster?103104## Document Removed Complexity105106If you removed features or options:107- Document why they were removed108- Consider if they need alternative access points109- Note any user feedback to monitor110111When the cuts feel right, hand off to `$impeccable polish` for the final pass. As Antoine de Saint-Exupéry put it: "Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away."112