agentleFS
adymireadymire/CraftLayer/skills/unslop-engine/SKILL.md

unslop-engine

Skill0 starsChanged 3 days agoMITView on GitHub

Create, audit, or improve interfaces while challenging generic visual choices without treating any style as automatically wrong.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    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:

    Use when creating a user-facing interface that needs a distinct product-led visual direction, auditing a weak or generic screen, or …

    line 10
  2. Distinctive:

    Do not use as a mandate to add visual novelty, remove familiar patterns, or rewrite a functional interface.

    line 16
  3. Distinctive:

    Look for unmotivated defaults: template-like hero copy, repeated feature cards, arbitrary gradients/glows, decorative empty space, random …

    line 33
  4. Distinctive:

    Check the same flow and important states at mobile and desktop sizes.

    line 42
  5. Distinctive:

    Use realistic domain data.

    line 50
  6. Distinctive:

    Never invent proof, screenshots, logos, capabilities, or chart data.

    line 51
  7. Distinctive:

    Verify that improvements retain functionality, responsive behavior, accessibility, product identity, and realistic content.

    line 72
  8. Distinctive:

    Use the evidence-led audit guide to structure a multi-screen review or to agree on severity and acceptance criteria before making visual …

    line 77

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Unslop Engine

When to use

Use when creating a user-facing interface that needs a distinct product-led visual direction, auditing a weak or generic screen, or improving an existing design without changing its intended behavior.

When not to use

Do not use as a mandate to add visual novelty, remove familiar patterns, or rewrite a functional interface. Do not treat gradients, cards, centered layouts, glass, or animation as defects by themselves.

Inputs and assumptions

Inspect the actual page, its purpose, audience, brand constraints, user journey, data, and existing implementation. Separate observable defects (for example, clipped content) from subjective choices (for example, a quiet palette).

Workflow

  1. Select Create, Audit, or Unslop mode and name the affected screen and primary task.
  2. Inspect real code and rendered states; note the intended hierarchy, content, layout, responsive behavior, and available design tokens.
  3. Look for unmotivated defaults: template-like hero copy, repeated feature cards, arbitrary gradients/glows, decorative empty space, random type, emoji as production icons, fake metrics, invented social proof, and generic domain-neutral dashboard patterns.
  4. For each finding, record evidence, severity, objective/subjective status, user impact, and a correction that preserves the user's goal.
  5. Rank work by task failure and clarity before aesthetic preference.
  6. Improve one coherent visual system: hierarchy, layout, typography, color, surfaces, content, and purposeful motion.
  7. Check the same flow and important states at mobile and desktop sizes.
  8. Re-audit changed areas and report remaining trade-offs.

Decision rules

  • A familiar pattern is acceptable when it makes the task easier and fits users' expectations.
  • A visual choice needs a product or usability reason, not just novelty.
  • Use realistic domain data; label illustrative or synthetic examples.
  • Never invent proof, screenshots, logos, capabilities, or chart data.
  • Preserve workflows, semantics, keyboard access, and brand constraints.

Example audit finding

Medium, objective: the primary action is visually indistinguishable from secondary links and falls below the data table. Users scanning the page may miss the next step. Move it beside the relevant heading and provide a clear focus style. Check that the action remains discoverable on narrow screens.

Common failures

  • Replacing one generic template with a different fashionable template.
  • Treating every audit observation as a blocker.
  • Removing useful cards or whitespace without understanding their purpose.
  • Improving screenshots while breaking responsive or keyboard behavior.

Validation

Report findings with affected component, severity, evidence, impact, objective/subjective classification, recommendation, and acceptance check. Verify that improvements retain functionality, responsive behavior, accessibility, product identity, and realistic content.

Supporting guide

Use the evidence-led audit guide to structure a multi-screen review or to agree on severity and acceptance criteria before making visual changes.

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.