About

Imported from AngeleyesTrue/ae-adk (internal/template/templates/.claude/skills/ae-design-impeccable/SKILL.md). Install upstream with npx skills add AngeleyesTrue/ae-adk --skill ae-design-impeccable. Copyright stays with the author (Apache-2.0).

Impeccable Design Skill

Name: ae-design-impeccable
Author: AngeleyesTrue

Distinctive, production-grade frontend design that avoids generic AI aesthetics. Based on pbakaus/impeccable (Apache 2.0), restructured for ae-adk.

Quick Reference

This skill provides five capabilities:

AI Slop Anti-Patterns — Curated ban list preventing generic AI-generated design. Two severity tiers: HARD (absolute ban) and SOFT (overridable with rationale).
Context Gathering Protocol — Mandatory pre-design information collection. No design without knowing the audience.
Self-Verification Tests — Three post-design checks: AI Slop Test, Squint Test, Brand Test.
Domain Reference Modules — Seven specialized guides: Typography, Color, Spatial, Motion, Interaction, Responsive, UX Writing.
Design Commands — Five slash commands: /design:audit, /design:normalize, /design:polish, /design:critique, /design:extract.

Activation: Loaded automatically when trigger keywords are detected by expert-frontend or designer agents. Not directly user-invocable.

Core Design Principles

Bold Direction Over Safe Defaults — Commit to a clear aesthetic point-of-view. Both refined minimalism and bold maximalism work. The key is intentionality, not intensity.
Context Before Code — Never start design work without knowing the audience, brand, and purpose. Code tells you what was built, not who it's for.
The AI Slop Test — If someone said "AI made this," would they believe it immediately? That's the problem. A distinctive interface makes someone ask "how was this made?"
OKLCH Over HSL — Perceptually uniform color space. Equal lightness steps look equal. Tint all neutrals toward brand hue.
Variety Over Monoculture — Every project deserves its own aesthetic. Vary fonts, themes, layouts, and approaches. Never converge on common choices.

AI Slop Anti-Patterns (Summary)

HARD (Absolute Ban — No Exceptions)

Category	Banned Patterns
Colors	Pure black (#000), pure gray (0 chroma), purple-blue AI gradients, cyan-on-dark
Effects	Glassmorphism, neon glow, gradient text (background-clip:text), side-stripe borders >1px
Layout	Hero metric template (big number + stats + gradient), large icons above every heading
Copy	"In today's fast-paced world", "Unlock the potential", AI marketing cliches

SOFT (Default Ban — Override via .impeccable.md with rationale)

Category	Banned Patterns
Fonts	Reflex font list (Inter, Roboto, Syne, DM Sans, Playfair, 20+ others)
Layouts	Identical card grids, 3-column icon-text, everything centered, cards-in-cards
Motion	Bounce/elastic easing, generic `ease`, animating layout properties

Full details: ${CLAUDE_SKILL_DIR}/modules/ai-slop-antipatterns.md

Context Gathering

When Required

New design system, page, or component design
Brand or visual identity work

When Skipped

Minor style fixes, color adjustments, typo corrections (HARD anti-pattern check still applies)

Resolution Order

Check loaded instructions for Design Context section
Check .impeccable.md at project root
Check .agency/context/visual-identity.md (read-only reference)
If none found: ask user before proceeding

Full protocol: ${CLAUDE_SKILL_DIR}/modules/context-gathering.md

.impeccable.md — P0 Minimal Schema

# .impeccable.md - Project Design Context

## Brand
- Name: {brand_name}
- Tone: {formal|casual|playful|corporate|...}
- Target Audience: {description}

## Design Decisions
- Primary Color: {hex/oklch}
- Typography: {font_stack}

## Anti-Pattern Overrides
- {pattern}: {rationale for allowing SOFT anti-pattern exception}

Place at project root. HARD anti-patterns can never be overridden. Only SOFT anti-patterns with explicit rationale.

Self-Verification Tests

Run after any design output is generated:

Test	What It Checks	Pass Criteria
AI Slop Test	HARD + SOFT anti-pattern violations	Zero HARD violations, zero unoverridden SOFT violations
Squint Test	Visual hierarchy via programmatic heuristic	2 of 3 checks pass (font-size steps, contrast differentiation, whitespace proportionality)
Brand Test	Consistency with .impeccable.md	All defined brand elements match

Full details: ${CLAUDE_SKILL_DIR}/modules/self-verification.md

Module Index

Module	File	Trigger Keywords	Priority
AI Slop Anti-Patterns	`modules/ai-slop-antipatterns.md`	design, build, UI, component	P0
Context Gathering	`modules/context-gathering.md`	new design, design system, brand	P0
Self-Verification	`modules/self-verification.md`	review, verify, test, audit	P1
Typography	`modules/typography-reference.md`	typography, font, type, modular scale	P1
Color & Contrast	`modules/color-contrast.md`	color, palette, OKLCH, tinted neutral	P1
Spatial Design	`modules/spatial-design.md`	layout, grid, spacing, hierarchy	P2
Motion Design	`modules/motion-design.md`	animation, motion, transition, easing	P2
Interaction Design	`modules/interaction-design.md`	interaction, form, focus, modal	P2
Responsive Design	`modules/responsive-design.md`	responsive, mobile, breakpoint, container query	P2
UX Writing	`modules/ux-writing.md`	copy, label, error message, empty state	P2

Modules load on-demand (Level 3 Progressive Disclosure). Only relevant modules are loaded per design session.

Command Reference

Command	Purpose	Details
`/design:audit`	Full design quality audit (AI Slop + accessibility + brand)	`${CLAUDE_SKILL_DIR}/commands/audit.md`
`/design:normalize`	Detect and suggest corrections for AI Slop patterns	`${CLAUDE_SKILL_DIR}/commands/normalize.md`
`/design:polish`	Fine-tune spacing, alignment, color, motion details	`${CLAUDE_SKILL_DIR}/commands/polish.md`
`/design:critique`	Independent design critique (anti-pattern perspective)	`${CLAUDE_SKILL_DIR}/commands/critique.md`
`/design:extract`	Extract design context from existing website/code	`${CLAUDE_SKILL_DIR}/commands/extract.md`

Works Well With

moai-design-craft

ae-design-impeccable: Anti-pattern detection and brand consistency
moai-design-craft: Intent-First design philosophy and design memory
On conflicting recommendations: Intent-First wins
Critique outputs: separated sections (Intent-First / Anti-Pattern)

moai-domain-uiux

ae-design-impeccable: Color theory (OKLCH, tinted neutrals), typography selection
moai-domain-uiux: WCAG compliance, design tokens (DTCG standard), theming, icons
No overlap. ae provides rules, moai provides token infrastructure.

agency-design-system

ae provides anti-pattern data that can inform agency's Dynamic Zone
Actual seeding is via learner agent or manual editing (Agency Constitution)
ae reads .agency/context/visual-identity.md as reference (never writes)

moai-design-tools

ae provides design rules and quality checks
moai-design-tools handles rendering (Figma MCP, Pencil renderer)

Usage Notes

Not user-invocable: Agents load this skill automatically via trigger keyword matching
Token budget: Max ~15,000 tokens concurrent (Level 2 5K + 2-3 modules ~3K each)
Project context: .impeccable.md is project-specific, stored at project root
Agency context: .agency/context/visual-identity.md is read-only reference
Upstream: moai-* skills are never modified (upstream immutable)
License: Apache 2.0, compatible with pbakaus/impeccable source
Reference: ${CLAUDE_SKILL_DIR}/reference.md for source links and tools

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/angeleyestrue-ae-adk-ae-design-impeccable/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

angeleyestrue-ae-adk-ae-design-impeccable.ocm.jsonjson

{
  "ocm": "1",
  "id": "angeleyestrue-ae-adk-ae-design-impeccable",
  "kind": "skill",
  "name": "ae-design-impeccable",
  "description": "Impeccable design system skill providing AI Slop anti-patterns, context gathering protocol, self-verification tests, and 7 domain reference modules. Eliminates generic AI-generated design patterns.",
  "publisher": "AngeleyesTrue",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "design",
      "impeccable",
      "ai-slop",
      "anti-patterns",
      "context-gathering",
      "verification",
      "typography",
      "color",
      "spatial"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Impeccable design system skill providing AI Slop anti-patterns, context gathering protocol, self-verification tests, and 7 domain reference modules. Eliminates generic AI-generated design patterns."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/AngeleyesTrue/ae-adk",
      "path": "internal/template/templates/.claude/skills/ae-design-impeccable/SKILL.md",
      "ref": "c494eaf241655c6072fbf95b6300da82a720b112",
      "url": "https://github.com/AngeleyesTrue/ae-adk/blob/c494eaf241655c6072fbf95b6300da82a720b112/internal/template/templates/.claude/skills/ae-design-impeccable/SKILL.md",
      "key": "AngeleyesTrue/ae-adk/internal/template/templates/.claude/skills/ae-design-impeccable/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Grep,",
      "Glob"
    ],
    "license": "Apache-2.0"
  },
  "instructions": "# Impeccable Design Skill\n\nDistinctive, production-grade frontend design that avoids generic AI aesthetics. Based on pbakaus/impeccable (Apache 2.0), restructured for ae-adk.\n\n## Quick Reference\n\nThis skill provides five capabilities:\n\n1. **AI Slop Anti-Patterns** — Curated ban list preventing generic AI-generated design. Two severity tiers: HARD (absolute ban) and SOFT (overridable with rationale).\n2. **Context Gathering Protocol** — Mandatory pre-design information collection. No design without knowing the audience.\n3. **Self-Verification Tests** — Three post-design checks: AI Slop Test, Squ",
  "cost": {
    "context_tokens": 1975
  }
}

Fetch it by URL: GET /api/v1/registry/angeleyestrue-ae-adk-ae-design-impeccable/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.