frontend-layout
Skill4 starsChanged 7 months agoMITView on GitHub
Use for landing pages, websites, apps, and UI where visual composition and structure are the primary concern. Enforces art direction, image-led hierarchy, content structure, and restrained motion. Complements frontend-design by focusing on layout and composition rules rather than aesthetic boldness.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- code-reviewSkill
- code-simplifierSkill
- comment-analyzerSkill
- conventions-improverSkill
- feature-devSkill
- frontend-designSkill
- gh-address-commentsSkill
- gh-fix-ciSkill
- mcp-server-devSkill
- review-toolkitSkill
- security-threat-modelSkill
- silent-failure-hunterSkill
- test-analyzerSkill
- type-design-analyzerSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
41 rules. About 0 are common, 40 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈40
Distinctive · estimate
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
- Distinctive: line 10
Use this skill when the quality of the work depends on art direction, hierarchy, restraint, imagery, and motion rather than component count.
- Distinctive: line 16
Before building, write three things:
- Distinctive: line 26
Start with composition, not components.
- Distinctive: line 27
Prefer a full-bleed hero or full-canvas visual anchor.
- Distinctive: line 29
Keep copy short enough to scan in seconds.
- Distinctive: line 30
Use whitespace, alignment, scale, cropping, and contrast before adding chrome.
- Distinctive: line 32
Default to cardless layouts.
- Distinctive: line 33
Treat the first viewport as a poster, not a document.
- Distinctive: line 50
No hero cards, stat strips, logo clouds, pill soup, or floating dashboards by default.
- Distinctive: line 51
Keep headlines to roughly 2-3 lines on desktop and readable in one glance on mobile.
- Distinctive: line 52
Keep the text column narrow and anchored to a calm area of the image.
- Distinctive: line 53
All text over imagery must maintain strong contrast and clear tap targets.
- Distinctive: line 55
If the first viewport still works after removing the image, the image is too weak.
- Distinctive: line 59
If the first screen includes a sticky/fixed header, that header counts against the hero.
- Very specific: line 60
When using 100vh/100svh heroes, subtract persistent UI chrome (calc(100svh - header-height)) or overlay the header instead of stacking it …
- Distinctive: line 64
Default to Linear-style restraint:
- Distinctive: line 88
If a panel can become plain layout without losing meaning, remove the card treatment.
- Distinctive: line 94
Use at least one strong, real-looking image for brands, venues, editorial pages, and lifestyle products.
- Distinctive: line 95
Prefer in-situ photography over abstract gradients or fake 3D objects.
- Distinctive: line 97
Do not use images with embedded signage, logos, or typographic clutter fighting the UI.
- Distinctive: line 98
Do not generate images with built-in UI frames, splits, cards, or panels.
- Distinctive: line 99
If multiple moments are needed, use multiple images, not one collage.
- Distinctive: line 105
Write in product language, not design commentary.
- Distinctive: line 109
Do not include prompt language or design commentary into the UI.
- Distinctive: line 112
If deleting 30 percent of the copy improves the page, keep deleting.
- Distinctive: line 116
When the work is a dashboard, app surface, admin tool, or operational workspace, default to utility copy over marketing copy.
- Distinctive: line 119
Start with the working surface itself: KPIs, charts, filters, tables, status, or task context.
- Distinctive: line 122
Avoid aspirational hero lines, metaphors, campaign-style language, and executive-summary banners on product surfaces unless specifically …
- Distinctive: line 124
If a sentence could appear in a homepage hero or ad, rewrite it until it sounds like product UI.
- Distinctive: line 125
If a section does not help someone operate, monitor, or decide, remove it.
- Distinctive: line 130
Use motion to create presence and hierarchy, not noise.
- Distinctive: line 138
Prefer Framer Motion when available for:
- Distinctive: line 157
No cards by default.
- Distinctive: line 158
No hero cards by default.
- Distinctive: line 159
No boxed or center-column hero when the brief calls for full bleed.
- Distinctive: line 160
No more than one dominant idea per section.
- Distinctive: line 161
No section should need many tiny UI devices to explain itself.
- Distinctive: line 162
No headline should overpower the brand on branded pages.
- Distinctive: line 164
No split-screen hero unless text sits on a calm, unified side.
- Distinctive: line 165
No more than two typefaces without a clear reason.
- Distinctive: line 166
No more than one accent color unless the product already has a strong system.
≈ “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.
Files
Frontend Layout
Use this skill when the quality of the work depends on art direction, hierarchy, restraint, imagery, and motion rather than component count.
Goal: ship interfaces that feel deliberate, premium, and current. Default toward award-level composition: one big idea, strong imagery, sparse copy, rigorous spacing, and a small number of memorable motions.
Working Model
Before building, write three things:
- visual thesis: one sentence describing mood, material, and energy
- content plan: hero, support, detail, final CTA
- interaction thesis: 2-3 motion ideas that change the feel of the page
Each section gets one job, one dominant visual idea, and one primary takeaway or action.
Beautiful Defaults
- Start with composition, not components.
- Prefer a full-bleed hero or full-canvas visual anchor.
- Make the brand or product name the loudest text.
- Keep copy short enough to scan in seconds.
- Use whitespace, alignment, scale, cropping, and contrast before adding chrome.
- Limit the system: two typefaces max, one accent color by default.
- Default to cardless layouts. Use sections, columns, dividers, lists, and media blocks instead.
- Treat the first viewport as a poster, not a document.
Landing Pages
Default sequence:
- Hero: brand or product, promise, CTA, and one dominant visual
- Support: one concrete feature, offer, or proof point
- Detail: atmosphere, workflow, product depth, or story
- Final CTA: convert, start, visit, or contact
Hero rules:
- One composition only.
- Full-bleed image or dominant visual plane.
- Canonical full-bleed rule: on branded landing pages, the hero itself must run edge-to-edge with no inherited page gutters, framed container, or shared max-width; constrain only the inner text/action column.
- Brand first, headline second, body third, CTA fourth.
- No hero cards, stat strips, logo clouds, pill soup, or floating dashboards by default.
- Keep headlines to roughly 2-3 lines on desktop and readable in one glance on mobile.
- Keep the text column narrow and anchored to a calm area of the image.
- All text over imagery must maintain strong contrast and clear tap targets.
If the first viewport still works after removing the image, the image is too weak. If the brand disappears after hiding the nav, the hierarchy is too weak.
Viewport budget:
- If the first screen includes a sticky/fixed header, that header counts against the hero. The combined header + hero content must fit within the initial viewport at common desktop and mobile sizes.
- When using
100vh/100svhheroes, subtract persistent UI chrome (calc(100svh - header-height)) or overlay the header instead of stacking it in normal flow.
Apps
Default to Linear-style restraint:
- calm surface hierarchy
- strong typography and spacing
- few colors
- dense but readable information
- minimal chrome
- cards only when the card is the interaction
For app UI, organize around:
- primary workspace
- navigation
- secondary context or inspector
- one clear accent for action or state
Avoid:
- dashboard-card mosaics
- thick borders on every region
- decorative gradients behind routine product UI
- multiple competing accent colors
- ornamental icons that do not improve scanning
If a panel can become plain layout without losing meaning, remove the card treatment.
Imagery
Imagery must do narrative work.
- Use at least one strong, real-looking image for brands, venues, editorial pages, and lifestyle products.
- Prefer in-situ photography over abstract gradients or fake 3D objects.
- Choose or crop images with a stable tonal area for text.
- Do not use images with embedded signage, logos, or typographic clutter fighting the UI.
- Do not generate images with built-in UI frames, splits, cards, or panels.
- If multiple moments are needed, use multiple images, not one collage.
The first viewport needs a real visual anchor. Decorative texture is not enough.
Copy
- Write in product language, not design commentary.
- Let the headline carry the meaning.
- Supporting copy should usually be one short sentence.
- Cut repetition between sections.
- Do not include prompt language or design commentary into the UI.
- Give every section one responsibility: explain, prove, deepen, or convert.
If deleting 30 percent of the copy improves the page, keep deleting.
Utility Copy For Product UI
When the work is a dashboard, app surface, admin tool, or operational workspace, default to utility copy over marketing copy.
- Prioritize orientation, status, and action over promise, mood, or brand voice.
- Start with the working surface itself: KPIs, charts, filters, tables, status, or task context. Do not introduce a hero section unless the user explicitly asks for one.
- Section headings should say what the area is or what the user can do there.
- Good: "Selected KPIs", "Plan status", "Search metrics", "Top segments", "Last sync".
- Avoid aspirational hero lines, metaphors, campaign-style language, and executive-summary banners on product surfaces unless specifically requested.
- Supporting text should explain scope, behavior, freshness, or decision value in one sentence.
- If a sentence could appear in a homepage hero or ad, rewrite it until it sounds like product UI.
- If a section does not help someone operate, monitor, or decide, remove it.
- Litmus check: if an operator scans only headings, labels, and numbers, can they understand the page immediately?
Motion
Use motion to create presence and hierarchy, not noise.
Ship at least 2-3 intentional motions for visually led work:
- one entrance sequence in the hero
- one scroll-linked, sticky, or depth effect
- one hover, reveal, or layout transition that sharpens affordance
Prefer Framer Motion when available for:
- section reveals
- shared layout transitions
- scroll-linked opacity, translate, or scale shifts
- sticky storytelling
- carousels that advance narrative, not just fill space
- menus, drawers, and modal presence effects
Motion rules:
- noticeable in a quick recording
- smooth on mobile
- fast and restrained
- consistent across the page
- removed if ornamental only
Hard Rules
- No cards by default.
- No hero cards by default.
- No boxed or center-column hero when the brief calls for full bleed.
- No more than one dominant idea per section.
- No section should need many tiny UI devices to explain itself.
- No headline should overpower the brand on branded pages.
- No filler copy.
- No split-screen hero unless text sits on a calm, unified side.
- No more than two typefaces without a clear reason.
- No more than one accent color unless the product already has a strong system.
Reject These Failures
- Generic SaaS card grid as the first impression
- Beautiful image with weak brand presence
- Strong headline with no clear action
- Busy imagery behind text
- Sections that repeat the same mood statement
- Carousel with no narrative purpose
- App UI made of stacked cards instead of layout
Litmus Checks
- Is the brand or product unmistakable in the first screen?
- Is there one strong visual anchor?
- Can the page be understood by scanning headlines only?
- Does each section have one job?
- Are cards actually necessary?
- Does motion improve hierarchy or atmosphere?
- Would the design still feel premium if all decorative shadows were removed?
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
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.

