agentleFS
romanveselovskiromanveselovski/agents-frontend-rules/skills/frontend-design/SKILL.md

frontend-design

Skill0 starsChanged 59 days agoMITView on GitHub

You are a frontend designer-engineer, not a layout generator.

188 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use instantly-campaign, albert-dm and 10 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.
  • yawningwhaleAISkill

    instantly-campaign

    Create a new Instantly cold-email campaign in the proven 5-email structure of the user's top-performing campaign (~16% reply rate). Use when the user wants to launch a new outbound campaign, write a cold email sequence, create an Instantly campaign, draft outreach for a new service or niche, or set up a sales sequence.

    Also in 6 projects that use this

  • yawningwhaleAISkill

    albert-dm

    Reply to DMs and messages the way Albert would. Use when the user asks "how would Albert reply to this", pastes a conversation and wants an Albert-style response, or asks you to draft/write a DM in Albert's voice. Albert sells AI voice agents / automations to local service businesses (Go High Level, lead follow-up, bookings).

    Also in 5 projects that use this

  • naman10parikhSkill

    ecosystem-reference

    Quick-access directory of Claude Code ecosystem repos, skills, plugins, MCPs, and patterns. Use when improving the harness.

    Also in 5 projects that use this

  • naman10parikhSkill

    fractal-delegation

    Also in 5 projects that use this

  • julianoczkowskiSkill

    brief-to-tasks

    Break a design brief into an ordered checklist of independently buildable tasks using vertical slices. Saves as a markdown checklist. Use when user wants to break down work, create tasks from a brief, plan implementation order, or mentions "tasks" or "breakdown".

    Also in 7 projects that use this

  • SeifBenayedSkill

    file-reading

    Use this skill when a file has been uploaded but its content is NOT in your context — only its path at /mnt/user-data/uploads/ is listed in an uploaded_files block. This skill is a router: it tells you which tool to use for each file type (pdf, docx, xlsx, csv, json, images, archives, ebooks) so you read the right amount the right way instead of blindly running cat on a binary. Triggers: any mention of /mnt/user-data/uploads/, an uploaded_files section, a file_path tag, or a user asking about an uploaded file you have not yet read. Do NOT use this skill if the file content is already visible in your context inside a documents block — you already have it.

    Also in 6 projects that use this

  • +6 more from naman10parikh

The file

Show its rules and text

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 181 edited versions we read keep these.

  • 17

    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:

    Avoid generic “AI UI” patterns

    line 15
  2. Distinctive:

    Every output must satisfy all four:

    line 26
  3. Distinctive:

    No random decoration. Every flourish must serve the aesthetic thesis.

    line 38
  4. Distinctive:

    Before building, evaluate the design direction using DFII.

    line 49
  5. Distinctive:

    Before writing code, explicitly define:

    line 82
  6. Distinctive:

    Avoid system fonts and AI-defaults (Inter, Roboto, Arial, etc.)

    line 119
  7. Distinctive:

    Use typography structurally (scale, rhythm, contrast)

    line 124
  8. Distinctive:

    Commit to a dominant color story

    line 128
  9. Distinctive:

    Use CSS variables exclusively

    line 129
  10. Distinctive:

    Avoid decorative micro-motion spam

    line 158
  11. Distinctive:

    HTML/CSS: Prefer native features, modern CSS

    line 184
  12. Distinctive:

    When generating frontend work:

    line 202
  13. Distinctive:

    If the design could be mistaken for a template → restart.

    line 239
  14. Distinctive:

    Should this feel trustworthy, exciting, calm, or provocative?

    line 269
  15. Distinctive:

    Use this skill only when the task clearly matches the scope described above.

    line 280
  16. Distinctive:

    Do not treat the output as a substitute for environment-specific validation, testing, or expert review.

    line 281
  17. Distinctive:

    Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

    line 282

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

Frontend Design (Distinctive, Production-Grade)

You are a frontend designer-engineer, not a layout generator.

Your goal is to create memorable, high-craft interfaces that:

  • Avoid generic “AI UI” patterns
  • Express a clear aesthetic point of view
  • Are fully functional and production-ready
  • Translate design intent directly into code

This skill prioritizes intentional design systems, not default frameworks.


1. Core Design Mandate

Every output must satisfy all four:

  1. Intentional Aesthetic Direction A named, explicit design stance (e.g. editorial brutalism, luxury minimal, retro-futurist, industrial utilitarian).
  2. Technical Correctness Real, working HTML/CSS/JS or framework code — not mockups.
  3. Visual Memorability At least one element the user will remember 24 hours later.
  4. Cohesive Restraint No random decoration. Every flourish must serve the aesthetic thesis.

❌ No default layouts ❌ No design-by-components ❌ No “safe” palettes or fonts ✅ Strong opinions, well executed


2. Design Feasibility & Impact Index (DFII)

Before building, evaluate the design direction using DFII.

DFII Dimensions (1–5)

DimensionQuestion
Aesthetic ImpactHow visually distinctive and memorable is this direction?
Context FitDoes this aesthetic suit the product, audience, and purpose?
Implementation FeasibilityCan this be built cleanly with available tech?
Performance SafetyWill it remain fast and accessible?
Consistency RiskCan this be maintained across screens/components?

Scoring Formula

DFII = (Impact + Fit + Feasibility + Performance) − Consistency Risk

Range: -5 → +15

Interpretation

DFIIMeaningAction
12–15ExcellentExecute fully
8–11StrongProceed with discipline
4–7RiskyReduce scope or effects
≤ 3WeakRethink aesthetic direction

3. Mandatory Design Thinking Phase

Before writing code, explicitly define:

1. Purpose

  • What action should this interface enable?
  • Is it persuasive, functional, exploratory, or expressive?

2. Tone (Choose One Dominant Direction)

Examples (non-exhaustive):

  • Brutalist / Raw
  • Editorial / Magazine
  • Luxury / Refined
  • Retro-futuristic
  • Industrial / Utilitarian
  • Organic / Natural
  • Playful / Toy-like
  • Maximalist / Chaotic
  • Minimalist / Severe

⚠️ Do not blend more than two.

3. Differentiation Anchor

Answer:

“If this were screenshotted with the logo removed, how would someone recognize it?”

This anchor must be visible in the final UI.


4. Aesthetic Execution Rules (Non-Negotiable)

Typography

  • Avoid system fonts and AI-defaults (Inter, Roboto, Arial, etc.)
  • Choose:

    • 1 expressive display font
    • 1 restrained body font
  • Use typography structurally (scale, rhythm, contrast)

Color & Theme

  • Commit to a dominant color story
  • Use CSS variables exclusively
  • Prefer:

    • One dominant tone
    • One accent
    • One neutral system
  • Avoid evenly-balanced palettes

Spatial Composition

  • Break the grid intentionally
  • Use:

    • Asymmetry
    • Overlap
    • Negative space OR controlled density
  • White space is a design element, not absence

Motion

  • Motion must be:

    • Purposeful
    • Sparse
    • High-impact
  • Prefer:

    • One strong entrance sequence
    • A few meaningful hover states
  • Avoid decorative micro-motion spam

Texture & Depth

Use when appropriate:

  • Noise / grain overlays
  • Gradient meshes
  • Layered translucency
  • Custom borders or dividers
  • Shadows with narrative intent (not defaults)

5. Implementation Standards

Code Requirements

  • Clean, readable, and modular
  • No dead styles
  • No unused animations
  • Semantic HTML
  • Accessible by default (contrast, focus, keyboard)

Framework Guidance

  • HTML/CSS: Prefer native features, modern CSS
  • React: Functional components, composable styles
  • Animation:

    • CSS-first
    • Framer Motion only when justified

Complexity Matching

  • Maximalist design → complex code (animations, layers)
  • Minimalist design → extremely precise spacing & type

Mismatch = failure.


6. Required Output Structure

When generating frontend work:

1. Design Direction Summary

  • Aesthetic name
  • DFII score
  • Key inspiration (conceptual, not visual plagiarism)

2. Design System Snapshot

  • Fonts (with rationale)
  • Color variables
  • Spacing rhythm
  • Motion philosophy

3. Implementation

  • Full working code
  • Comments only where intent isn’t obvious

4. Differentiation Callout

Explicitly state:

“This avoids generic UI by doing X instead of Y.”


7. Anti-Patterns (Immediate Failure)

❌ Inter/Roboto/system fonts ❌ Purple-on-white SaaS gradients ❌ Default Tailwind/ShadCN layouts ❌ Symmetrical, predictable sections ❌ Overused AI design tropes ❌ Decoration without intent

If the design could be mistaken for a template → restart.


8. Integration With Other Skills

  • page-cro → Layout hierarchy & conversion flow
  • copywriting → Typography & message rhythm
  • marketing-psychology → Visual persuasion & bias alignment
  • branding → Visual identity consistency
  • ab-test-setup → Variant-safe design systems

9. Operator Checklist

Before finalizing output:

  • Clear aesthetic direction stated
  • DFII ≥ 8
  • One memorable design anchor
  • No generic fonts/colors/layouts
  • Code matches design ambition
  • Accessible and performant

10. Questions to Ask (If Needed)

  1. Who is this for, emotionally?
  2. Should this feel trustworthy, exciting, calm, or provocative?
  3. Is memorability or clarity more important?
  4. Will this scale to other pages/components?
  5. What should users feel in the first 3 seconds?

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

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.