AGF Design Discipline
Review design specs and prototypes against aesthetic standards and anti-AI-slop guidelines.
Installation
- Make sure Claude is on your device and in your terminal.
Skills load from
~/.claude/skills/when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then runclaudein any terminal to verify.One-time setupnpm i -g @anthropic-ai/claude-codeAlready have it? Skip ahead.
- Paste into Claude Code or into your terminal.
This copies the whole skill folder into
~/.claude/skills/agf-design-discipline-pcliangx/— the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.Faster alternative (instruction-only skills)
Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.
Quick install (SKILL.md only)Sign up to copy - Restart Claude Code.
Quit and reopen Claude Code (or any other agent that loads from
~/.claude/skills/). New skills are picked up on startup. - Just ask Claude.
Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.
Prefer to read the source first? Open on GitHub.
When Claude uses it
Use when uiux-designer is about to produce a design spec (spec.md) or static HTML prototype, or frontend-dev is about to build UI from a design. Provides the anti-AI-slop design discipline layer — Brief Inference (Design Read), three aesthetic dials tuned for product UI, AI Tells blacklist with overrides, mechanically-checkable Pre-Flight. Sits above the token layer (DESIGN.md) and mechanical review (code-reviewer); does not redeclare tokens or guide non-shadcn design systems. Inspired by taste-skill, cropped for AGF product UI per ADR-013.
What this skill does
AGF Design Discipline
This skill enforces the aesthetic judgment layer of AGF's design governance—above the token layer (DESIGN.md) and mechanical code review, orthogonal to both. Use it when a uiux-designer is about to produce a feature spec.md or prototype, or when a frontend-dev is about to build UI from a design. It provides a Design Read declaration, three tuned aesthetic dials, an anti-AI-slop blacklist with override paths, and a mechanically-checkable pre-flight checklist. It does not redeclare tokens, does not grep for hardcoded values, and does not guide non-shadcn design systems.
What it does
- Design Read declaration: Before writing any design or code, output one sentence anchoring the page type (product UI vs. marketing page), audience, style language, and three aesthetic dials—preventing the LLM from skipping requirements and applying default aesthetics.
- Three aesthetic dials (VARIANCE, MOTION, DENSITY): Style parameters derived from brief signals that drive layout, animation, and information density choices; default AGF product UI is VARIANCE ≤ 5, MOTION ≤ 4, DENSITY medium.
- Product UI motion red lines: Explicitly bans scroll-hijacking, parallax, GSAP ScrollTrigger, kinetic typography, and
window.addEventListener('scroll')on product pages (allowed only on marketing pages with explicit PL sign-off). - AI Tells blacklist (§4): Detects high-frequency LLM "flavor"—neon gradients, pure black/white, three-column equal-height feature cards, fake names/brands, emoji as icons, div-faked screenshots—each with override conditions.
- Pre-flight checklist: Splits into mechanically-verifiable items (no hardcoded hex / px values, full
min-h-[100dvh], no Inter default, colors from DESIGN.md tokens) and human-review items (AI Tells, motion red lines, state coverage).
How to use it
When a designer or developer is about to produce a feature spec or UI, run through this skill. Start by outputting a Design Read statement (one sentence per §1B template) at the top of spec.md, anchoring page type, audience, style language, and the three dial values inferred from the brief. Then work through the AI Tells blacklist (§4) and pre-flight checks (§5)—use the bash script agf-design-precheck.sh for mechanical verification. Hand off to code-reviewer only after all nine self-check dimensions pass and the Design Read is in place.
Related skills
Generative Code Art
anthropics
Create algorithmic art with p5.js using randomness and interactive parameters.
UI/UX Pro Max
anthropics
Build production-grade web components and interfaces with distinctive, polished design.
Artifact Theme Toolkit
anthropics
Apply professional color and font themes to slides, docs, and web pages.
Multi-Component Web Artifacts
anthropics
Build complex React artifacts with Tailwind CSS and shadcn/ui components.