agentleFS
markoblogomarkoblogo/abvx-agent-skills/skills/frontend-taste-layer/SKILL.md

frontend-taste-layer

Skill16 starsChanged 5 months agoMITView on GitHub

Set and review a bounded, creator-aware visual direction for marketing, editorial, portfolio, and brand-forward frontend work. Use when a surface needs an explicit design read, creator-intent check, calibrated composition/motion/density, preservation-first redesign, layout-rhythm review, or desktop/mobile/reduced-motion verification. Route product UI to Lazyweb and UX review instead.

The file

Show its rules and text

We split this skill into the rules it gives an agent

31 rules. About 0 are common, 28 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈28

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

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

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

    Use this after the task is understood and the surface register is known.

    line 14
  2. Very specific:

    If the caller repository has PRODUCT.md or DESIGN.md, read only the relevant sections as design context.

    line 16
  3. Distinctive:

    If one page mixes both registers, apply this skill only to the marketing/editorial regions.

    line 37
  4. Distinctive:

    Before changing code, state one sentence:

    line 41
  5. Distinctive:

    Do not skip this. Most generic output comes from styling before the read is explicit.

    line 45
  6. Distinctive:

    Before widening into polish, state briefly:

    line 53
  7. Distinctive:

    If the answer is still too vague to guide a real choice, ask one sharp clarifying question, not a survey.

    line 59
  8. Distinctive:

    Use them to keep decisions consistent.

    line 71
  9. Distinctive:

    Before changing an existing surface, write two short lists:

    line 75
  10. Distinctive:

    Do not silently rewrite content, replace supplied assets, swap the design system, or broaden the redesign scope.

    line 80
  11. Distinctive:

    Do not default to purple-blue AI gradients.

    line 84
  12. Distinctive:

    Do not default to Inter plus slate gray plus centered hero.

    line 85
  13. Distinctive:

    Do not solve every section with identical cards.

    line 86
  14. Distinctive:

    Do not use decorative glass or blur everywhere.

    line 87
  15. Distinctive:

    Do not use serif as a reflex for “premium” or “creative”.

    line 88
  16. Distinctive:

    Do not make the page feel like a template category before it feels like this product or brand.

    line 89
  17. Distinctive:

    Commit to a typography hierarchy with a real point of view.

    line 93
  18. Distinctive:

    Use asymmetry when the surface benefits from it.

    line 94
  19. Distinctive:

    If using motion, make it directional and purposeful, not generic reveal spam.

    line 96
  20. Distinctive:

    Keep one palette family per page and lock the accent.

    line 97
  21. Distinctive:

    Prefer a deliberate visual anchor over more decorative chrome.

    line 98
  22. Distinctive:

    Every animation must communicate hierarchy, feedback, state change, or narrative.

    line 102
  23. Distinctive:

    Avoid motion on high-frequency or keyboard-triggered interactions.

    line 103
  24. Distinctive:

    Prefer crisp, short, origin-aware motion over broad cinematic transitions in product UI.

    line 104
  25. Very specific:

    After implementing meaningful motion, run motion-review-gate before calling the surface ship-ready.

    line 105
  26. Distinctive:

    If a surface is product-first, use this skill as a restraint-and-hierarchy layer, not an invitation to make it loud.

    line 112
  27. Distinctive:

    Verify design choices against real viewport behavior.

    line 116
  28. Distinctive:

    If the project already has tokens or a component system, bend them intelligently before replacing them.

    line 120
  29. Distinctive:

    When consecutive marketing sections repeat the same split, equal-card grid, or centered-stack composition without a content reason, change …

    line 126
  30. Distinctive:

    Before calling the reviewed surface ready, verify:

    line 130
  31. Distinctive:

    every visible string, including navigation, headings, buttons, labels, captions, alt text, and loading, empty, error, or disabled states …

    line 135

≈ “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

Frontend Taste Layer

Raise the taste level without turning the work into a random aesthetic stunt.

Use this after the task is understood and the surface register is known. If the project still lacks design context, start with design-register-bootstrap.

If the caller repository has PRODUCT.md or DESIGN.md, read only the relevant sections as design context. Those files do not authorize redesign or unrelated edits. If context is absent, propose a compact contract only when the task needs it.

Best Fit

  • landing pages;
  • portfolios;
  • brand-forward promo pages;
  • redesigns where the current UI feels boilerplate or interchangeable;
  • hero sections and first-screen composition work.

Not The Best Fit

  • dense dashboards;
  • table-heavy app UI;
  • settings forms where utility matters more than expressive styling;
  • projects that must preserve a strict existing enterprise design system.

Route Before Styling

  • For marketing, editorial, portfolio, and brand-forward pages, continue with this skill.
  • For dashboards, settings, onboarding, checkout, paywalls, and other product UI, use Lazyweb evidence first, then user-experience, design-critique-polish, or the project's product-specific skill.
  • If one page mixes both registers, apply this skill only to the marketing/editorial regions. Product-task clarity wins at the seam.

Design Read

Before changing code, state one sentence:

Reading this as: <surface> for <audience>, with a <vibe> language, leaning toward <design family>.

Do not skip this. Most generic output comes from styling before the read is explicit.

Compact Design Context

Use existing product/design documents when available; do not require new files for a small change. A compact PRODUCT.md can record audience, user jobs, surface register and non-goals; DESIGN.md can record typography, color, layout rhythm, motion, component rules and justified detector waivers. Propose additions within the task's scope rather than creating a second brand book.

Creator Intent Check

Before widening into polish, state briefly:

  • what the person is actually trying to make possible;
  • what must remain recognizably theirs;
  • which single decision most changes first-use experience.

If the answer is still too vague to guide a real choice, ask one sharp clarifying question, not a survey. If ambiguity does not block a real choice, move.

Three Dials

Set these as relative directions for the pass; do not impose universal numeric defaults:

  • variance: symmetry versus surprise;
  • motion: static versus cinematic;
  • density: airy versus packed.

Use them to keep decisions consistent. Do not expose a pile of disconnected visual tweaks.

Audit First On Redesigns

Before changing an existing surface, write two short lists:

  • preserve: approved copy, brand assets, tokens, working interactions, content hierarchy, accessibility behavior, and explicit owner constraints;
  • reconsider: only the composition, typography, density, motion, or section rhythm that the brief permits changing.

Do not silently rewrite content, replace supplied assets, swap the design system, or broaden the redesign scope.

Anti-Slop Rules

  • Do not default to purple-blue AI gradients.
  • Do not default to Inter plus slate gray plus centered hero.
  • Do not solve every section with identical cards.
  • Do not use decorative glass or blur everywhere.
  • Do not use serif as a reflex for “premium” or “creative”.
  • Do not make the page feel like a template category before it feels like this product or brand.

Positive Moves

  • Commit to a typography hierarchy with a real point of view.
  • Use asymmetry when the surface benefits from it.
  • Make one strong visual decision per screen: type, composition, color, or motion.
  • If using motion, make it directional and purposeful, not generic reveal spam.
  • Keep one palette family per page and lock the accent.
  • Prefer a deliberate visual anchor over more decorative chrome.

Motion Taste Rules

  • Every animation must communicate hierarchy, feedback, state change, or narrative. If its purpose cannot be stated in one sentence, remove it.
  • Avoid motion on high-frequency or keyboard-triggered interactions.
  • Prefer crisp, short, origin-aware motion over broad cinematic transitions in product UI.
  • After implementing meaningful motion, run motion-review-gate before calling the surface ship-ready.

Brand Versus Product

  • For brand surfaces, visual identity can lead.
  • For product surfaces, taste should sharpen clarity, not compete with workflow.

If a surface is product-first, use this skill as a restraint-and-hierarchy layer, not an invitation to make it loud.

Frontend Engineering Constraints

  • Verify design choices against real viewport behavior.
  • Text must stay inside containers.
  • Contrast must survive the more expressive palette.
  • Motion must respect reduced-motion settings.
  • If the project already has tokens or a component system, bend them intelligently before replacing them.

Layout Rhythm Review

  • Name each section's layout family, then flag accidental repetition that flattens distinct content roles.
  • Repetition is not automatically a defect: navigation, lists, and comparable records may need it.
  • When consecutive marketing sections repeat the same split, equal-card grid, or centered-stack composition without a content reason, change the smallest high-leverage section rather than reskinning the page.

Evidence Pass

Before calling the reviewed surface ready, verify:

  1. one representative desktop width;
  2. one representative mobile width;
  3. prefers-reduced-motion behavior when motion exists;
  4. every visible string, including navigation, headings, buttons, labels, captions, alt text, and loading, empty, error, or disabled states that belong to the reviewed path;
  5. preserved items from the redesign audit are still intact.
  6. where applicable, the strongest visual decision still holds through first use, failure, recovery, and repetition instead of working only as a first-demo impression; for static surfaces record N/A.

Build success and source inspection do not count as visual verification. If browser evidence is unavailable, report INSUFFICIENT_VISUAL_EVIDENCE.

Final Report

Include:

  • the design read;
  • the relative variance, motion, and density direction;
  • what was preserved during redesign;
  • what anti-slop defaults were deliberately avoided;
  • key visual decisions changed;
  • desktop, mobile, reduced-motion, and visible-copy evidence;
  • whether the result still feels authored and usable across first use, failure, recovery, and repetition;
  • what still remains intentionally plain because the product context demands it.

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.