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
- Read
src/lib/config/tenant.config.ts to understand brand identity
- Read
src/app/globals.css to understand the design token palette
- Read
tailwind.config.ts for font and color configuration
- 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)
2. Tone & Mood (Weight: HIGH)
3. Typography (Weight: MEDIUM — only if text present)
4. Composition & Quality (Weight: MEDIUM)
5. Visual Motifs (Weight: LOW)
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:
- Individual audit for each image
- 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?
- 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.
1---2name: asset-brand-check-23description: Audit generated image assets against the platform's brand guidelines. Use before publishing to verify color palette, typography, tone, and visual consistency.4user-invocable: true5allowed-tools: Read, Write, Edit, Bash, Grep, Glob6metadata:7 source: https://skillmd.com/skills/joshuashepherd/asset-brand-check-28---910Audit image assets against brand guidelines: $ARGUMENTS1112$ARGUMENTS should include:13- Path(s) to the image(s) to audit (file or directory)14- Optionally: specific brand concerns to check15- Optionally: the intended use context (hero, OG card, course cover, etc.)16- Empty — ask the user for the image path1718## Before Starting19201. Read `src/lib/config/tenant.config.ts` to understand brand identity212. Read `src/app/globals.css` to understand the design token palette223. Read `tailwind.config.ts` for font and color configuration234. Load the image(s) to audit2425## Brand Guidelines — Alan Hirsch Platform2627### Color Palette2829#### Approved Colors30| Role | Token | Hex Range | Description |31|------|-------|-----------|-------------|32| Primary | `--primary` | Warm amber/gold tones | CTAs, accents, highlights |33| Background | `--background` | Cream to warm white | Page backgrounds |34| Foreground | `--foreground` | Warm charcoal to dark brown | Text, headings |35| Muted | `--muted` | Warm grey, sage undertones | Secondary text, borders |36| Card | `--card` | Cream, warm white | Card surfaces |37| Accent | `--accent` | Terracotta, warm amber | Badges, highlights |3839#### Color Affinities (preferred in generated images)40- Terracotta: `#C75B39` range41- Amber/Gold: `#D4A84B` range42- Sage: `#87A878` range43- Cream: `#FAF5E4` range44- Warm Charcoal: `#2C2C2C` to `#3D3D3D`45- Warm Grey: `#8B8680` range4647#### Color Violations (flag these)48- ❌ Pure black (#000000) backgrounds49- ❌ Cold/corporate blues (#0066CC, #1a73e8)50- ❌ Neon or high-saturation colors51- ❌ Pure white (#FFFFFF) as dominant background (should be warm cream)52- ❌ Cool greys without warm undertones53- ❌ Gradient rainbow / multi-colored effects5455### Tone & Mood5657#### Approved Qualities58- ✅ Warm, inviting, relational59- ✅ Scholarly but accessible60- ✅ Missional, communal, formational61- ✅ Grounded, authentic, practical62- ✅ Contemplative, thoughtful depth6364#### Tone Violations (flag these)65- ❌ Corporate, sterile, clinical66- ❌ Stock-photo generic (perfectly posed business people)67- ❌ Overly polished / artificial perfection68- ❌ Dark, edgy, aggressive69- ❌ Playful / cartoonish (unless specifically for a casual context)70- ❌ Tech-bro / startup aesthetic7172### Typography in Images7374#### Approved Styles75- Serif fonts for titles/quotes (Playfair Display, Merriweather family)76- Clean sans-serif for body/labels (Inter, Open Sans family)77- Condensed sans-serif for impact (Oswald family)7879#### Typography Violations80- ❌ Comic Sans, papyrus, or novelty fonts81- ❌ All-caps body text (all-caps OK for short labels/badges)82- ❌ Text with insufficient contrast (< 4.5:1 ratio)83- ❌ Text without clear hierarchy (all same size/weight)84- ❌ Decorative/script fonts for body text8586### Visual Motifs8788#### On-Brand Motifs89- Open books, journals, handwritten notes90- Community gatherings, small groups, circles91- Urban neighborhoods, streets, doorways92- Maps, pathways, compass imagery93- Natural textures: wood, linen, paper, stone94- Shared meals, bread, table settings95- Seeds, seedlings, growth imagery9697#### Off-Brand Motifs98- ❌ Corporate offices, boardrooms99- ❌ Solo individuals on pedestals/stages (unless teaching context)100- ❌ Technology/screens as the central subject101- ❌ Military/conquest imagery102- ❌ Luxury/wealth signaling103104## Audit Checklist105106For each image, evaluate against these dimensions:107108### 1. Color Palette Alignment (Weight: HIGH)109- [ ] Dominant colors match brand palette (warm earth tones)110- [ ] No cold/corporate colors dominating111- [ ] No neon or oversaturated elements112- [ ] Dark mode assets use warm darks, not pure black113114### 2. Tone & Mood (Weight: HIGH)115- [ ] Feels warm and inviting116- [ ] Scholarly but not cold117- [ ] Communal/relational, not individualistic118- [ ] Authentic, not stock-photo generic119120### 3. Typography (Weight: MEDIUM — only if text present)121- [ ] Font styles match brand family122- [ ] Text hierarchy is clear123- [ ] Contrast meets WCAG AA (4.5:1)124- [ ] No novelty or inappropriate fonts125126### 4. Composition & Quality (Weight: MEDIUM)127- [ ] Appropriate aspect ratio for intended use128- [ ] No AI artifacts (extra fingers, distorted text, etc.)129- [ ] Resolution sufficient for intended display size130- [ ] Composition supports content placement (negative space for text overlays)131132### 5. Visual Motifs (Weight: LOW)133- [ ] Imagery aligns with brand motifs134- [ ] No off-brand subject matter135- [ ] Cultural sensitivity appropriate136137## Execution138139### Step 1 — Load Images140Read each image file using the Read tool (supports PNG, JPG, WebP).141142### Step 2 — Visual Analysis143For each image, analyze against all 5 dimensions. Use your multimodal understanding to assess:144- Dominant colors and their warmth/coolness145- Overall mood and tone146- Text legibility and style (if present)147- Composition quality148- Subject matter appropriateness149150### Step 3 — Score and Report151152## Output Format153154```155## Brand Audit Report156157### Image: public/images/generated/hero/mdna.png158### Intended Use: Hero image for course detail page159160### Scores161| Dimension | Score | Status |162|-----------|-------|--------|163| Color Palette | 9/10 | ✅ Pass |164| Tone & Mood | 8/10 | ✅ Pass |165| Typography | 7/10 | ⚠️ Minor issues |166| Composition | 9/10 | ✅ Pass |167| Visual Motifs | 10/10 | ✅ Pass |168169### Overall: ✅ APPROVED (43/50)170171### Details172173#### Color Palette (9/10) ✅174- Dominant warm amber and terracotta tones — on brand175- Background gradient uses cream to warm gold — excellent176- Minor: small area of slightly cool grey in shadow region177178#### Tone & Mood (8/10) ✅179- Warm, scholarly feel — matches brand180- Community gathering scene feels authentic181- Minor: lighting slightly dramatic for a platform that values accessibility182183#### Typography (7/10) ⚠️184- Title text uses appropriate serif font185- Subtitle contrast is borderline (estimated 3.8:1) — recommend darkening text or adding overlay186- ACTION: Increase subtitle text contrast187188#### Composition (9/10) ✅189- Good negative space for text overlay on the right190- Subject placement follows rule of thirds191- Resolution sufficient for hero display (2048px)192193#### Visual Motifs (10/10) ✅194- Small group gathered around a table — perfect brand alignment195- Books and journals visible — on-brand scholarly motif196- Natural lighting through windows — warm, authentic197198### Recommended Refinements1991. **Increase subtitle contrast** — darken text or add semi-transparent overlay200 → Use `/asset-edit` with: "Darken the subtitle text to improve contrast against the background"2012. **Slightly warm the shadow areas** — shift cool grey shadows toward warm grey202 → Use `/asset-edit` with: "Warm up the shadow areas, shifting from cool grey toward warm brown-grey"203204### Verdict205Image is ready for use with minor text contrast adjustment recommended.206```207208## Batch Audit209210When auditing a directory of images (e.g., a full series), provide:2111. Individual audit for each image2122. Cross-image consistency check:213 - Are all images using the same color palette?214 - Is the lighting direction consistent?215 - Is the composition template consistent?216 - Are there outliers that break the visual rhythm?2173. Summary table with pass/fail for each image218219## Scoring Guide220221| Score | Status | Meaning |222|-------|--------|---------|223| 9-10 | ✅ Pass | On-brand, ready for production |224| 7-8 | ⚠️ Minor | Usable with minor refinements recommended |225| 5-6 | 🔶 Moderate | Needs refinement before publishing |226| 1-4 | ❌ Fail | Off-brand, regenerate or major edit needed |227228Threshold for approval: 35/50 overall, with no single dimension below 5/10.