# Asset Brand Check > Audit generated image assets against the platform's brand guidelines. Use before publishing to verify color palette, typography, tone, and visual consistency. - Skill: `joshuashepherd/asset-brand-check-2` (Agent Skill) - Install (CLI): `npx skillmds@latest add joshuashepherd/asset-brand-check-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/joshuashepherd/asset-brand-check-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Design & Media - Author: JoshuaShepherd (https://skillmd.com/u/joshuashepherd) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/joshuashepherd/asset-brand-check-2 --- Audit image assets against brand guidelines: $ARGUMENTS $ARGUMENTS should include: - Path(s) to the image(s) to audit (file or directory) - Optionally: specific brand concerns to check - Optionally: the intended use context (hero, OG card, course cover, etc.) - Empty — ask the user for the image path ## Before Starting 1. Read `src/lib/config/tenant.config.ts` to understand brand identity 2. Read `src/app/globals.css` to understand the design token palette 3. Read `tailwind.config.ts` for font and color configuration 4. Load the image(s) to audit ## Brand Guidelines — Alan Hirsch Platform ### Color Palette #### Approved Colors | Role | Token | Hex Range | Description | |------|-------|-----------|-------------| | Primary | `--primary` | Warm amber/gold tones | CTAs, accents, highlights | | Background | `--background` | Cream to warm white | Page backgrounds | | Foreground | `--foreground` | Warm charcoal to dark brown | Text, headings | | Muted | `--muted` | Warm grey, sage undertones | Secondary text, borders | | Card | `--card` | Cream, warm white | Card surfaces | | Accent | `--accent` | Terracotta, warm amber | Badges, highlights | #### Color Affinities (preferred in generated images) - Terracotta: `#C75B39` range - Amber/Gold: `#D4A84B` range - Sage: `#87A878` range - Cream: `#FAF5E4` range - Warm Charcoal: `#2C2C2C` to `#3D3D3D` - Warm Grey: `#8B8680` range #### Color Violations (flag these) - ❌ Pure black (#000000) backgrounds - ❌ Cold/corporate blues (#0066CC, #1a73e8) - ❌ Neon or high-saturation colors - ❌ Pure white (#FFFFFF) as dominant background (should be warm cream) - ❌ Cool greys without warm undertones - ❌ Gradient rainbow / multi-colored effects ### Tone & Mood #### Approved Qualities - ✅ Warm, inviting, relational - ✅ Scholarly but accessible - ✅ Missional, communal, formational - ✅ Grounded, authentic, practical - ✅ Contemplative, thoughtful depth #### Tone Violations (flag these) - ❌ Corporate, sterile, clinical - ❌ Stock-photo generic (perfectly posed business people) - ❌ Overly polished / artificial perfection - ❌ Dark, edgy, aggressive - ❌ Playful / cartoonish (unless specifically for a casual context) - ❌ Tech-bro / startup aesthetic ### Typography in Images #### Approved Styles - Serif fonts for titles/quotes (Playfair Display, Merriweather family) - Clean sans-serif for body/labels (Inter, Open Sans family) - Condensed sans-serif for impact (Oswald family) #### Typography Violations - ❌ Comic Sans, papyrus, or novelty fonts - ❌ All-caps body text (all-caps OK for short labels/badges) - ❌ Text with insufficient contrast (< 4.5:1 ratio) - ❌ Text without clear hierarchy (all same size/weight) - ❌ Decorative/script fonts for body text ### Visual Motifs #### On-Brand Motifs - Open books, journals, handwritten notes - Community gatherings, small groups, circles - Urban neighborhoods, streets, doorways - Maps, pathways, compass imagery - Natural textures: wood, linen, paper, stone - Shared meals, bread, table settings - Seeds, seedlings, growth imagery #### Off-Brand Motifs - ❌ Corporate offices, boardrooms - ❌ Solo individuals on pedestals/stages (unless teaching context) - ❌ Technology/screens as the central subject - ❌ Military/conquest imagery - ❌ Luxury/wealth signaling ## Audit Checklist For each image, evaluate against these dimensions: ### 1. Color Palette Alignment (Weight: HIGH) - [ ] Dominant colors match brand palette (warm earth tones) - [ ] No cold/corporate colors dominating - [ ] No neon or oversaturated elements - [ ] Dark mode assets use warm darks, not pure black ### 2. Tone & Mood (Weight: HIGH) - [ ] Feels warm and inviting - [ ] Scholarly but not cold - [ ] Communal/relational, not individualistic - [ ] Authentic, not stock-photo generic ### 3. Typography (Weight: MEDIUM — only if text present) - [ ] Font styles match brand family - [ ] Text hierarchy is clear - [ ] Contrast meets WCAG AA (4.5:1) - [ ] No novelty or inappropriate fonts ### 4. Composition & Quality (Weight: MEDIUM) - [ ] Appropriate aspect ratio for intended use - [ ] No AI artifacts (extra fingers, distorted text, etc.) - [ ] Resolution sufficient for intended display size - [ ] Composition supports content placement (negative space for text overlays) ### 5. Visual Motifs (Weight: LOW) - [ ] Imagery aligns with brand motifs - [ ] No off-brand subject matter - [ ] Cultural sensitivity appropriate ## Execution ### Step 1 — Load Images Read each image file using the Read tool (supports PNG, JPG, WebP). ### Step 2 — Visual Analysis For each image, analyze against all 5 dimensions. Use your multimodal understanding to assess: - Dominant colors and their warmth/coolness - Overall mood and tone - Text legibility and style (if present) - Composition quality - Subject matter appropriateness ### Step 3 — Score and Report ## Output Format ``` ## Brand Audit Report ### Image: public/images/generated/hero/mdna.png ### Intended Use: Hero image for course detail page ### Scores | Dimension | Score | Status | |-----------|-------|--------| | Color Palette | 9/10 | ✅ Pass | | Tone & Mood | 8/10 | ✅ Pass | | Typography | 7/10 | ⚠️ Minor issues | | Composition | 9/10 | ✅ Pass | | Visual Motifs | 10/10 | ✅ Pass | ### Overall: ✅ APPROVED (43/50) ### Details #### Color Palette (9/10) ✅ - Dominant warm amber and terracotta tones — on brand - Background gradient uses cream to warm gold — excellent - Minor: small area of slightly cool grey in shadow region #### Tone & Mood (8/10) ✅ - Warm, scholarly feel — matches brand - Community gathering scene feels authentic - Minor: lighting slightly dramatic for a platform that values accessibility #### Typography (7/10) ⚠️ - Title text uses appropriate serif font - Subtitle contrast is borderline (estimated 3.8:1) — recommend darkening text or adding overlay - ACTION: Increase subtitle text contrast #### Composition (9/10) ✅ - Good negative space for text overlay on the right - Subject placement follows rule of thirds - Resolution sufficient for hero display (2048px) #### Visual Motifs (10/10) ✅ - Small group gathered around a table — perfect brand alignment - Books and journals visible — on-brand scholarly motif - Natural lighting through windows — warm, authentic ### Recommended Refinements 1. **Increase subtitle contrast** — darken text or add semi-transparent overlay → Use `/asset-edit` with: "Darken the subtitle text to improve contrast against the background" 2. **Slightly warm the shadow areas** — shift cool grey shadows toward warm grey → Use `/asset-edit` with: "Warm up the shadow areas, shifting from cool grey toward warm brown-grey" ### Verdict Image is ready for use with minor text contrast adjustment recommended. ``` ## Batch Audit When auditing a directory of images (e.g., a full series), provide: 1. Individual audit for each image 2. Cross-image consistency check: - Are all images using the same color palette? - Is the lighting direction consistent? - Is the composition template consistent? - Are there outliers that break the visual rhythm? 3. Summary table with pass/fail for each image ## Scoring Guide | Score | Status | Meaning | |-------|--------|---------| | 9-10 | ✅ Pass | On-brand, ready for production | | 7-8 | ⚠️ Minor | Usable with minor refinements recommended | | 5-6 | 🔶 Moderate | Needs refinement before publishing | | 1-4 | ❌ Fail | Off-brand, regenerate or major edit needed | Threshold for approval: 35/50 overall, with no single dimension below 5/10.