brand-evaluation-rubric
Skill0 starsChanged 5 months agoMITView on GitHub
Grade visual identity with two A-F scores (Design Score / AI-Slop) and a 10 anti-pattern detector — makes principle P-03 measurable. Use it in 03 (closing BRANDBOOK) and 08 (QA gate, on the real app).
In this repository20 other files it gives its agents.
- docs/AGENTS.mdAGENTS.md
- adopt-groundSkill
- agent-authoringSkill
- architecture-decisionSkill
- asset-sourcingSkill
- criticSkill
- data-integritySkill
- diagrams-gateSkill
- drift-protocolSkill
- env-reproducibleSkill
- orchestrator-bridgeSkill
- project-cleanupSkill
- qa-eyesSkill
- qa-visual-criteriaSkill
- research-methodologySkill
- security-auditSkill
- setupSkill
- smoke-testSkill
- technical-documentationSkill
- visualizerSkill
The file
Files
SKILL: brand-evaluation-rubric — Design Score / AI-Slop (Agents 03 and 08)
Purpose. Make principle P-03 ("nothing generic, with its own personality") measurable. It stops being opinion: two scores with an A–F grade and evidence.
Origin: adapted from gstack
/plan-design-review. Used by Agent 03 (closing BRANDBOOK) and Agent 08 (at the QA gate, on the real app).
Two scores
- Design Score (A–F): does it have personality, hierarchy, coherence, intent?
- AI-Slop Score (A–F): how much does it look like "made by an AI with no taste"? (A = no slop; F = pure template.)
Report the at-a-glance reaction first (3 sentences): what it communicates, where the eye goes first, and a one-word verdict. That's the most valuable part; the rest is evidence.
AI-Slop detector (10 anti-patterns — each present lowers the grade)
- Purple/blue hero gradient.
- 3-column grid with icons in circles.
Inter(or another neutral sans) on EVERYTHING, with no second display font.- Everything centered, no asymmetry or focus.
- Uniform, bubbly
border-radiuseverywhere. - Floating blobs/decorations with no function.
- Flat heading scale (36/24/18 with no drama).
- Spacing with no rhythm (all 16/24, no real grid).
- "Get Started"/CTA button identical to any SaaS.
- Palette with no intent (>12 non-grey colors, or an accent with no usage rules).
Categories to grade (A–F each)
Typography · Spacing/rhythm · Hierarchy · Color · Interaction states · Motion · Density/focus · Coherence with the declared identity (BRANDBOOK/TOKENS) · Personality (memorable or template?) · Visual accessibility (contrast).
Output
Design Score: B+ | AI-Slop Score: A-
Glance: "Feels like an esports scoreboard, not a SaaS. The eye goes to the win rate.
In one word: competitive."
AI-Slop: 0/10 anti-patterns present (no gradient, no 3-col grid, 2 fonts...).
Top improvements: 1) ... (severity) 2) ...- For Agent 03: if AI-Slop < A- or Design < B, iterate before closing the gate.
- For Agent 08: run the rubric on the real app (with
qa-eyes), not on the mockup. - Zero hardcoded hex/fonts outside the tokens = a requirement, not an opinion.
Rejection/approval criteria + workflow (merged from brand-evaluation, v6.3)
Folded in from the
brand-evaluationskill (Agent 03) without losing content. Complements the scoring rubric with binary reject/approve criteria + Agent 03's workflow.
Reject internally and reformulate if it has one or more:
- Palette dominated by corporate blue + white + grey.
- Generic sans-serif typeface with no defined personality.
- Dashboard layout (left sidebar + header + cards) as the main structure with no specific justification.
- Landing page with a big hero + three feature columns.
- Trendy gradients unrelated to the product's personality.
- Generic line iconography with no system of its own.
- Anything that could serve any other product without changing a thing.
Approve if:
- The palette has an explainable narrative rationale.
- The typography has hierarchy with purpose.
- The layout responds to how the user uses the product.
- Someone can tell what kind of product it is without reading the name.
- The proposal could not be applied to another product without modifying it.
Workflow (Agent 03):
- Gather references from the PO before proposing anything.
- Generate at least 3 distinct visual directions.
- Internal evaluation against the rejection criteria.
- Present to the PO with enough context to decide.
- Iterate until explicit approval.
- Convert the approved brandbook into CSS tokens.
Common mistakes: proposing before gathering references · presenting variations of the same concept as distinct options · moving to tokens without explicit approval · defining tokens by size instead of by use.
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.

