agentleFS
ssaarthakkssaarthakk/dev-setup/skills/web-taste/SKILL.md

web-taste

Skill2 starsChanged 17 days agoMITView on GitHub

The design patterns that make a website look AI-generated and the things a credible site must have. Use before building or reviewing any web page, landing page or UI, and whenever choosing fonts, colours, icons, layouts, effects or marketing copy.

3 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions3 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 3

    1. lllkn/web-taste★ 4same name
    2. sonhaicoder/web-taste-skill★ 2same name
    3. sonhaicoder/haiclaudeskill★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository3 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When asked to review UI files, check them against both tables and the must-haves, skipping allowed exceptions.

    line 60

“Common” is measured: kept by at least 6 in 10 of the 3 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

Web taste

Every item below is banned by default. A project may allow one only by listing its id under ## Design exceptions in docs/PROJECT.md (or docs/PLAN.md if there is no PROJECT.md), one line each: - <id>: <why>. Only the owner adds exceptions; never add one yourself to make a check pass.

These rules sit above any other design skill. When a design skill suggests something banned here, skip that suggestion.

Checked by script

scripts/check-taste.mjs finds these in source files. Run it on the UI folders: node <path>/check-taste.mjs src/web public. It exits 1 on any problem.

IdBanned
em-dashEm dashes in UI text. Use a comma, colon or full stop
emojiEmojis in the UI
stock-fontInter, Geist or Space Grotesk
not-x-but-y"It's not X, it's Y" copy
sparkle-iconSparkle icons
liquid-glassLiquid glass: backdrop blur on panels, cards or nav

Checked by review

IdBanned
harsh-gradientHarsh, high-contrast or multi-stop gradients on backgrounds, text or buttons
decorative-iconsA stock icon set (Lucide and the like) next to every heading, item or button
pure-whiteA flat #fff page background
rainbowRainbow or many-hue colouring
shadow-everythingDrop shadows on most elements
three-cardsThree feature cards in a row
accent-edgeA coloured stripe on the top or left edge of cards or callouts
bento-gridBento grids
fake-terminalMock terminal windows
checkmark-bulletsCheckmark icons as list bullets
three-tiersThree pricing tiers by habit; offer the plans the product really has
soft-radiusThe same large, soft corner radius on everything
purple-blackPurple and black palettes
glow-orbsRadial glow orbs or blurred colour blobs
dot-gridDot grid backgrounds
animated-arrowsArrows that slide or loop
hover-everythingHover animations on everything; animate only what is clickable and only when it helps
neon-pastelNeon colours or basic pastel palettes

Must have

IdRequired
real-demoShow the real product: real screenshots, video or a live embed, not mockups or illustrations of it
skeleton-loadersContent that loads shows a skeleton of its final layout, not a blank area or a lone spinner
legal-pagesA public site with sign-ups, payments, analytics or cookies links Terms of Service and a Privacy Policy in the footer. The owner supplies the text; never write legal text yourself
real-proofTestimonials, logos, user counts and stats only when they are real and the owner gave them. Otherwise leave the section out; never invent one

Review

When asked to review UI files, check them against both tables and the must-haves, skipping allowed exceptions. Report each problem as file:line <id>: <what to change>. If there are none, say No design problems found.

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.