agentleFS
excattexcatt/superclaude-plusplus/skills/distill/SKILL.md

distill

Skill14 starsChanged 37 days agoMITView on GitHub

Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. Use when the user asks to simplify, declutter, reduce noise, remove elements, or make a UI cleaner and more focused.

75 other projects use a version of this, 29 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use archive, ckm:design-system and 6 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ReScienceLabSkill

    archive

    Archive session learnings, debugging solutions, and deployment logs to .archive/yyyy-mm-dd/ as indexed markdown with searchable tags. Use when completing a significant task, resolving a tricky bug, deploying, or when the user says \"archive this\". Maintains .archive/MEMORY.md index for cross-session knowledge reuse.

    Also in 3 projects that use this

  • klauswgSkill

    ckm:design-system

    Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.

    Also in 3 projects that use this

  • iovisorSkill

    evolve

    Evolve uBPF through a gated spec-first workflow that propagates approved changes through requirements, design, validation, implementation, and RFC alignment artifacts.

    Also in 3 projects that use this

  • termdockSkill

    recall

    Retrieves cross-session memories about past decisions, lessons, and patterns. Use when user asks about prior work, past decisions, or mentions a feature. Triggers include check memory, what did we decide, how did we solve.

    Also in 5 projects that use this

  • corygabrielsenSkill

    spike

    Implement N approaches as separate branches, then compare side-by-side. Removes "implementation effort" as a variable from the decision.

    Also in 3 projects that use this

  • MicrosoftSkill

    doctor

    Diagnose an Amplifier CLI environment through the CLI doctor agent. USE WHEN a user requests CLI runtime, settings or missing-capability inspection. DO NOT USE for project bugs or other hosts.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

16 rules. 0 are common, 16 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 68 edited versions we read keep these.

  • 16

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Remove unnecessary complexity from designs, revealing the essential elements and creating clarity through ruthless simplification.

    line 9
  2. Distinctive:

    If any of these are unclear from the codebase, STOP and call the AskUserQuestion tool to clarify.

    line 35
  3. Distinctive:

    Create a ruthless editing strategy:

    line 41
  4. Distinctive:

    Reduce scope: Remove secondary actions, optional features, redundant information

    line 55
  5. Distinctive:

    Remove redundancy: If it's said elsewhere, don't repeat it here

    line 59
  6. Distinctive:

    Reduce color palette: Use 1-2 colors plus neutrals, not 5-7 colors

    line 62
  7. Distinctive:

    Consistent spacing: Use one spacing scale, remove arbitrary gaps

    line 67
  8. Distinctive:

    Full-width: Use available space generously instead of complex multi-column layouts

    line 72
  9. Distinctive:

    Essential information only: Remove marketing fluff, legalese, hedging

    line 88
  10. Distinctive:

    Remove redundant copy: No headers restating intros, no repeated explanations, say it once

    line 89
  11. Distinctive:

    Remove necessary functionality (simplicity ≠ feature-less)

    line 98
  12. Distinctive:

    Remove information users need to make decisions

    line 101
  13. Distinctive:

    Ensure simplification improves usability:

    line 107
  14. Distinctive:

    If you removed features or options:

    line 117
  15. Distinctive:

    Document why they were removed

    line 118
  16. Distinctive:

    Consider if they need alternative access points

    line 119

“Common” is measured: kept by at least 6 in 10 of the 68 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Remove unnecessary complexity from designs, revealing the essential elements and creating clarity through ruthless simplification.

MANDATORY PREPARATION

Invoke /impeccable — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first.


Assess Current State

Analyze what makes the design feel complex or cluttered:

  1. Identify complexity sources:
    • Too many elements: Competing buttons, redundant information, visual clutter
    • Excessive variation: Too many colors, fonts, sizes, styles without purpose
    • Information overload: Everything visible at once, no progressive disclosure
    • Visual noise: Unnecessary borders, shadows, backgrounds, decorations
    • Confusing hierarchy: Unclear what matters most
    • Feature creep: Too many options, actions, or paths forward
  2. Find the essence:
    • What's the primary user goal? (There should be ONE)
    • What's actually necessary vs nice-to-have?
    • What can be removed, hidden, or combined?
    • What's the 20% that delivers 80% of value?

If any of these are unclear from the codebase, STOP and call the AskUserQuestion tool to clarify.

CRITICAL: Simplicity is not about removing features - it's about removing obstacles between users and their goals. Every element should justify its existence.

Plan Simplification

Create a ruthless editing strategy:

  • Core purpose: What's the ONE thing this should accomplish?
  • Essential elements: What's truly necessary to achieve that purpose?
  • Progressive disclosure: What can be hidden until needed?
  • Consolidation opportunities: What can be combined or integrated?

IMPORTANT: Simplification is hard. It requires saying no to good ideas to make room for great execution. Be ruthless.

Simplify the Design

Systematically remove complexity across these dimensions:

Information Architecture

  • Reduce scope: Remove secondary actions, optional features, redundant information
  • Progressive disclosure: Hide complexity behind clear entry points (accordions, modals, step-through flows)
  • Combine related actions: Merge similar buttons, consolidate forms, group related content
  • Clear hierarchy: ONE primary action, few secondary actions, everything else tertiary or hidden
  • Remove redundancy: If it's said elsewhere, don't repeat it here

Visual Simplification

  • Reduce color palette: Use 1-2 colors plus neutrals, not 5-7 colors
  • Limit typography: One font family, 3-4 sizes maximum, 2-3 weights
  • Remove decorations: Eliminate borders, shadows, backgrounds that don't serve hierarchy or function
  • Flatten structure: Reduce nesting, remove unnecessary containers—never nest cards inside cards
  • Remove unnecessary cards: Cards aren't needed for basic layout; use spacing and alignment instead
  • Consistent spacing: Use one spacing scale, remove arbitrary gaps

Layout Simplification

  • Linear flow: Replace complex grids with simple vertical flow where possible
  • Remove sidebars: Move secondary content inline or hide it
  • Full-width: Use available space generously instead of complex multi-column layouts
  • Consistent alignment: Pick left or center, stick with it
  • Generous white space: Let content breathe, don't pack everything tight

Interaction Simplification

  • Reduce choices: Fewer buttons, fewer options, clearer path forward (paradox of choice is real)
  • Smart defaults: Make common choices automatic, only ask when necessary
  • Inline actions: Replace modal flows with inline editing where possible
  • Remove steps: Can signup be one step instead of three? Can checkout be simplified?
  • Clear CTAs: ONE obvious next step, not five competing actions

Content Simplification

  • Shorter copy: Cut every sentence in half, then do it again
  • Active voice: "Save changes" not "Changes will be saved"
  • Remove jargon: Plain language always wins
  • Scannable structure: Short paragraphs, bullet points, clear headings
  • Essential information only: Remove marketing fluff, legalese, hedging
  • Remove redundant copy: No headers restating intros, no repeated explanations, say it once

Code Simplification

  • Remove unused code: Dead CSS, unused components, orphaned files
  • Flatten component trees: Reduce nesting depth
  • Consolidate styles: Merge similar styles, use utilities consistently
  • Reduce variants: Does that component need 12 variations, or can 3 cover 90% of cases?

NEVER:

  • Remove necessary functionality (simplicity ≠ feature-less)
  • Sacrifice accessibility for simplicity (clear labels and ARIA still required)
  • Make things so simple they're unclear (mystery ≠ minimalism)
  • Remove information users need to make decisions
  • Eliminate hierarchy completely (some things should stand out)
  • Oversimplify complex domains (match complexity to actual task complexity)

Verify Simplification

Ensure simplification improves usability:

  • Faster task completion: Can users accomplish goals more quickly?
  • Reduced cognitive load: Is it easier to understand what to do?
  • Still complete: Are all necessary features still accessible?
  • Clearer hierarchy: Is it obvious what matters most?
  • Better performance: Does simpler design load faster?

Document Removed Complexity

If you removed features or options:

  • Document why they were removed
  • Consider if they need alternative access points
  • Note any user feedback to monitor

Remember: You have great taste and judgment. Simplification is an act of confidence - knowing what to keep and courage to remove the rest. As Antoine de Saint-Exupéry said: "Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away."

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.