UI Template Audit
Find the defaults a page inherited without deciding on them, score how much they dominate, and replace each one with a choice that comes from the product.
A "template default" is not a forbidden pattern. A numbered list is fine when order matters; a logo row is fine when the logos are real customers who agreed to be shown. The problem is a pattern used because it was the first thing that came to hand, not because the content needed it. This audit is judgment, not law: record why each finding matters for this page.
When to Use
- A page was generated quickly (by an agent, a starter kit, or a UI kit) and now needs a review
- Stakeholders say the site "feels generic" but can't say why
- Before a launch, as a final pass after functionality works
- When building a design system, to decide which defaults to keep on purpose
When NOT to Use
- The brief explicitly asks for a conventional or familiar look (internal admin tools, government forms, a pastiche) — familiarity is a feature there
- The page is not built yet — use
visual-direction first
- You only need an accessibility check — use
accessible-by-default
Relationship to Other Skills
Anthropic's official frontend-design skill guides building distinctive UI (aesthetic direction, typography, plan-review-build-critique). This skill is the audit counterpart: a repeatable checklist for an existing page, with a score and a fix list. Use frontend-design for generation and this skill for review; they do not conflict.
Workflow
Step 1: Gather the Page and the Brief
Collect, before judging anything:
- The rendered page (screenshot at desktop and ~375px mobile width) or the source
- What the product is, who uses it, and what one action the page should drive
- Any brand assets that already exist (logo, product screenshots, real photos, real customer names)
Without the brief you can only detect sameness, not decide what should replace it.
Step 2: Run the Checklist
Mark each item Present, Partly, or Absent. Note the exact selector, section, or line.
| # |
Template default |
What to look for |
| 1 |
Default gradient palette |
Purple/indigo/blue gradients on hero or buttons, especially on white or near-black, with no link to the brand |
| 2 |
Eyebrow labels everywhere |
Small, tracked, uppercase (often monospace) labels above every section heading |
| 3 |
Decorative numbering |
"01 / 02 / 03" on items whose order carries no meaning |
| 4 |
Sloganeering headline |
Headline that would fit any product ("Build faster. Ship smarter.", "The future of X") |
| 5 |
Three equal feature cards |
A row of three same-sized cards, icon + title + two lines, repeated down the page |
| 6 |
Logo wall without consent or context |
"Trusted by" row of logos that are placeholders, unverified, or unexplained |
| 7 |
Unverifiable statistics |
"10x faster", "99.9% satisfaction", "10,000+ teams" with no source |
| 8 |
Stock testimonials |
Quotes with first name only, generic avatar, no company or link |
| 9 |
Emoji or icon bullets |
Emoji or generic line icons used as list bullets or feature markers |
| 10 |
Decorative arrows |
"Learn more →" arrows added to every link or button |
| 11 |
Glassmorphism by default |
Blurred translucent panels over a gradient blob, not motivated by layered content |
| 12 |
Gradient text |
Headline words filled with a gradient as the main emphasis device |
| 13 |
Single-word emphasis |
One word in a headline highlighted, underlined, or colored as a reflex |
| 14 |
Uniform rounding and shadow |
Every element shares one large radius and one soft shadow |
| 15 |
Centered everything |
All sections centered, same max-width, same vertical rhythm |
| 16 |
Generic hero illustration |
Abstract 3D shapes, isometric people, or blobs instead of the actual product |
| 17 |
Motion on everything |
Fade-up on scroll for every block; no prefers-reduced-motion handling |
| 18 |
Default font stack as identity |
One sans-serif at default weights carrying everything, nothing chosen |
| 19 |
Placeholder copy patterns |
"Seamless", "powerful", "all-in-one", "supercharge", "unlock" |
| 20 |
FAQ and pricing boilerplate |
Three tiers with "Most popular" badge regardless of the actual offer |
Step 3: Score
Score each item: Absent = 0, Partly = 1, Present = 2. Weight the items that most affect trust and comprehension:
| Weight |
Items |
| x3 (trust) |
6, 7, 8 |
| x2 (identity) |
1, 4, 16, 18, 19 |
| x1 (style) |
everything else |
Interpret the total as a priority signal, not a grade:
| Total |
Reading |
| 0-8 |
Mostly intentional; fix individual items |
| 9-20 |
Noticeably templated; fix the trust and identity items first |
| 21+ |
The page has no direction yet; run visual-direction before patching |
The thresholds are a working heuristic for prioritising, not a validated metric. Say so if you report the score.
Step 4: Write the Fix for Each Finding
Every finding needs a replacement that comes from the product. "Remove the gradient" is incomplete; say what goes there instead.
| Finding |
Weak fix |
Specific fix |
| Sloganeering headline |
Rewrite to be punchier |
State what it does for whom: "Turn court bookings into a schedule your members can see" |
| Unverifiable stat |
Soften the number |
Remove it, or replace with a fact you can source ("Used at 14 clubs in Pune" if true and approved) |
| Three equal cards |
Make them four |
Lead with the single most important capability at full width; list the rest compactly |
| Eyebrow labels |
Make them smaller |
Delete them; let the heading carry the section. Keep a label only where it adds information (a date, a status) |
| Generic hero illustration |
Change the illustration |
Show the product: a real screenshot, a short loop of the core flow, or a real photo |
| Decorative numbering |
Use letters instead |
Remove numbers unless the steps must happen in order |
| Logo wall |
Fewer logos |
Keep only logos you have permission to show; add one sentence on how each uses the product, or drop the row |
Step 5: Report
Use this structure:
## Template audit: <page>
Brief: <product, audience, one goal>
Score: <n> (heuristic; trust items weighted x3)
### Trust (fix before launch)
- [7] Hero stat "10x faster" (hero.tsx:42) has no source. Remove, or cite the measurement.
### Identity
- [4] Headline "The future of scheduling" fits any product. Proposed: "<specific line>".
### Style
- [2] Uppercase eyebrow above all 7 section headings. Delete; keep the date label on Changelog.
### Keep (intentional)
- Numbered steps in "How setup works": order matters here.
Always include a Keep section. An audit that strips everything produces a different template, not a better page.
Example: Before and After
<!-- Before -->
<section class="hero bg-gradient-to-r from-indigo-500 to-purple-600 text-center">
<span class="eyebrow">AI-POWERED PLATFORM</span>
<h1>Supercharge your <span class="gradient-text">workflow</span></h1>
<p>The all-in-one platform trusted by 10,000+ teams.</p>
<a href="/signup">Get started →</a>
</section>
<!-- After (for a hypothetical invoicing tool for freelance translators) -->
<section class="hero">
<h1>Invoice by word count, in the client's currency</h1>
<p>Paste a project's word count and rate; get a PDF invoice with the
exchange rate you used printed on it.</p>
<a href="/signup">Create your first invoice</a>
<img src="/screens/invoice-from-wordcount.png"
alt="Invoice form with 4,200 words at 0.08 EUR per word, total 336 EUR">
</section>
The "after" is not more decorated; it is more specific. Visual styling then follows from the direction, not from a kit.
Best Practices
- Audit against the brief, not against a list of banned styles
- Fix trust items (fake stats, unconsented logos, stock testimonials) first; they carry legal and credibility risk
- Pair every removal with a specific replacement
- Record intentional choices in a Keep section so the next pass doesn't undo them
- Check mobile: many template patterns (equal cards, centered stacks) look worse at narrow widths
- Re-run the checklist after fixes; replacing one default with another is common
- Run
accessible-by-default as a separate pass; distinctive is never a reason to drop accessibility
References
1---2name: ui-template-audit3description: |4 Audit an existing UI, landing page, or screenshot for "template defaults" — the patterns that make interfaces read as generic or machine-generated — and produce a scored report with specific fixes.5 Use this skill when reviewing a page that "looks like every other AI-built site", before shipping a landing page, or when asked to make a design feel less generic.6 Activate when: generic UI, looks AI-generated, template look, design review, landing page critique, make it less generic, design audit, AI slop design.7metadata:8 source: https://skillmd.com/skills/latestaiagents/ui-template-audit9---1011# UI Template Audit1213**Find the defaults a page inherited without deciding on them, score how much they dominate, and replace each one with a choice that comes from the product.**1415A "template default" is not a forbidden pattern. A numbered list is fine when order matters; a logo row is fine when the logos are real customers who agreed to be shown. The problem is a pattern used because it was the first thing that came to hand, not because the content needed it. This audit is judgment, not law: record why each finding matters for *this* page.1617## When to Use1819- A page was generated quickly (by an agent, a starter kit, or a UI kit) and now needs a review20- Stakeholders say the site "feels generic" but can't say why21- Before a launch, as a final pass after functionality works22- When building a design system, to decide which defaults to keep on purpose2324## When NOT to Use2526- The brief explicitly asks for a conventional or familiar look (internal admin tools, government forms, a pastiche) — familiarity is a feature there27- The page is not built yet — use `visual-direction` first28- You only need an accessibility check — use `accessible-by-default`2930## Relationship to Other Skills3132Anthropic's official `frontend-design` skill guides *building* distinctive UI (aesthetic direction, typography, plan-review-build-critique). This skill is the *audit* counterpart: a repeatable checklist for an existing page, with a score and a fix list. Use `frontend-design` for generation and this skill for review; they do not conflict.3334## Workflow3536### Step 1: Gather the Page and the Brief3738Collect, before judging anything:39401. The rendered page (screenshot at desktop and ~375px mobile width) or the source412. What the product is, who uses it, and what one action the page should drive423. Any brand assets that already exist (logo, product screenshots, real photos, real customer names)4344Without the brief you can only detect sameness, not decide what should replace it.4546### Step 2: Run the Checklist4748Mark each item **Present**, **Partly**, or **Absent**. Note the exact selector, section, or line.4950| # | Template default | What to look for |51|---|------------------|------------------|52| 1 | Default gradient palette | Purple/indigo/blue gradients on hero or buttons, especially on white or near-black, with no link to the brand |53| 2 | Eyebrow labels everywhere | Small, tracked, uppercase (often monospace) labels above every section heading |54| 3 | Decorative numbering | "01 / 02 / 03" on items whose order carries no meaning |55| 4 | Sloganeering headline | Headline that would fit any product ("Build faster. Ship smarter.", "The future of X") |56| 5 | Three equal feature cards | A row of three same-sized cards, icon + title + two lines, repeated down the page |57| 6 | Logo wall without consent or context | "Trusted by" row of logos that are placeholders, unverified, or unexplained |58| 7 | Unverifiable statistics | "10x faster", "99.9% satisfaction", "10,000+ teams" with no source |59| 8 | Stock testimonials | Quotes with first name only, generic avatar, no company or link |60| 9 | Emoji or icon bullets | Emoji or generic line icons used as list bullets or feature markers |61| 10 | Decorative arrows | "Learn more →" arrows added to every link or button |62| 11 | Glassmorphism by default | Blurred translucent panels over a gradient blob, not motivated by layered content |63| 12 | Gradient text | Headline words filled with a gradient as the main emphasis device |64| 13 | Single-word emphasis | One word in a headline highlighted, underlined, or colored as a reflex |65| 14 | Uniform rounding and shadow | Every element shares one large radius and one soft shadow |66| 15 | Centered everything | All sections centered, same max-width, same vertical rhythm |67| 16 | Generic hero illustration | Abstract 3D shapes, isometric people, or blobs instead of the actual product |68| 17 | Motion on everything | Fade-up on scroll for every block; no `prefers-reduced-motion` handling |69| 18 | Default font stack as identity | One sans-serif at default weights carrying everything, nothing chosen |70| 19 | Placeholder copy patterns | "Seamless", "powerful", "all-in-one", "supercharge", "unlock" |71| 20 | FAQ and pricing boilerplate | Three tiers with "Most popular" badge regardless of the actual offer |7273### Step 3: Score7475Score each item: Absent = 0, Partly = 1, Present = 2. Weight the items that most affect trust and comprehension:7677| Weight | Items |78|--------|-------|79| x3 (trust) | 6, 7, 8 |80| x2 (identity) | 1, 4, 16, 18, 19 |81| x1 (style) | everything else |8283Interpret the total as a priority signal, not a grade:8485| Total | Reading |86|-------|---------|87| 0-8 | Mostly intentional; fix individual items |88| 9-20 | Noticeably templated; fix the trust and identity items first |89| 21+ | The page has no direction yet; run `visual-direction` before patching |9091The thresholds are a working heuristic for prioritising, not a validated metric. Say so if you report the score.9293### Step 4: Write the Fix for Each Finding9495Every finding needs a replacement that comes from the product. "Remove the gradient" is incomplete; say what goes there instead.9697| Finding | Weak fix | Specific fix |98|---------|----------|--------------|99| Sloganeering headline | Rewrite to be punchier | State what it does for whom: "Turn court bookings into a schedule your members can see" |100| Unverifiable stat | Soften the number | Remove it, or replace with a fact you can source ("Used at 14 clubs in Pune" if true and approved) |101| Three equal cards | Make them four | Lead with the single most important capability at full width; list the rest compactly |102| Eyebrow labels | Make them smaller | Delete them; let the heading carry the section. Keep a label only where it adds information (a date, a status) |103| Generic hero illustration | Change the illustration | Show the product: a real screenshot, a short loop of the core flow, or a real photo |104| Decorative numbering | Use letters instead | Remove numbers unless the steps must happen in order |105| Logo wall | Fewer logos | Keep only logos you have permission to show; add one sentence on how each uses the product, or drop the row |106107### Step 5: Report108109Use this structure:110111```markdown112## Template audit: <page>113114Brief: <product, audience, one goal>115Score: <n> (heuristic; trust items weighted x3)116117### Trust (fix before launch)118- [7] Hero stat "10x faster" (hero.tsx:42) has no source. Remove, or cite the measurement.119120### Identity121- [4] Headline "The future of scheduling" fits any product. Proposed: "<specific line>".122123### Style124- [2] Uppercase eyebrow above all 7 section headings. Delete; keep the date label on Changelog.125126### Keep (intentional)127- Numbered steps in "How setup works": order matters here.128```129130Always include a **Keep** section. An audit that strips everything produces a different template, not a better page.131132## Example: Before and After133134```html135<!-- Before -->136<section class="hero bg-gradient-to-r from-indigo-500 to-purple-600 text-center">137 <span class="eyebrow">AI-POWERED PLATFORM</span>138 <h1>Supercharge your <span class="gradient-text">workflow</span></h1>139 <p>The all-in-one platform trusted by 10,000+ teams.</p>140 <a href="/signup">Get started →</a>141</section>142143<!-- After (for a hypothetical invoicing tool for freelance translators) -->144<section class="hero">145 <h1>Invoice by word count, in the client's currency</h1>146 <p>Paste a project's word count and rate; get a PDF invoice with the147 exchange rate you used printed on it.</p>148 <a href="/signup">Create your first invoice</a>149 <img src="/screens/invoice-from-wordcount.png"150 alt="Invoice form with 4,200 words at 0.08 EUR per word, total 336 EUR">151</section>152```153154The "after" is not more decorated; it is more specific. Visual styling then follows from the direction, not from a kit.155156## Best Practices1571581. Audit against the brief, not against a list of banned styles1592. Fix trust items (fake stats, unconsented logos, stock testimonials) first; they carry legal and credibility risk1603. Pair every removal with a specific replacement1614. Record intentional choices in a Keep section so the next pass doesn't undo them1625. Check mobile: many template patterns (equal cards, centered stacks) look worse at narrow widths1636. Re-run the checklist after fixes; replacing one default with another is common1647. Run `accessible-by-default` as a separate pass; distinctive is never a reason to drop accessibility165166## References167168- Anthropic `frontend-design` skill: https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md169- `frontend-design` Claude Code plugin (official marketplace): https://github.com/anthropics/claude-plugins-official/tree/main/plugins/frontend-design170- MDN, `prefers-reduced-motion`: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-reduced-motion