Aiwg brand-compliance
Validate brand compliance across visual, verbal, and legal dimensions with actionable reports
install
source · Clone the upstream repo
git clone https://github.com/jmagly/aiwg
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/brand-compliance" ~/.claude/skills/jmagly-aiwg-brand-compliance && rm -rf "$T"
manifest:
.agents/skills/brand-compliance/SKILL.mdsource content
brand-compliance
Unified brand compliance validation across visual, verbal, and legal dimensions.
Triggers
Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):
- "brand police" → brand guideline enforcement
- "on-brand check" → brand consistency validation
Purpose
This skill provides comprehensive brand compliance validation by:
- Checking visual identity (colors, logos, typography)
- Validating verbal identity (tone, voice, terminology)
- Verifying claims and legal requirements
- Ensuring accessibility compliance
- Generating actionable compliance reports
Behavior
When triggered, this skill:
-
Loads brand guidelines:
- Visual identity from
.aiwg/marketing/brand/ - Voice profile from voice-framework
- Legal requirements from compliance config
- Visual identity from
-
Analyzes visual elements:
- Color palette compliance
- Logo usage correctness
- Typography standards
- Layout and spacing
-
Validates verbal content:
- Tone consistency with brand voice
- Terminology correctness
- Messaging alignment
- Tagline usage
-
Checks legal compliance:
- Claims substantiation
- Required disclosures
- Trademark usage
- Privacy statements
-
Validates accessibility:
- WCAG 2.1 AA standards
- Color contrast ratios
- Alt text presence
- Readable font sizes
-
Generates compliance report:
- Pass/fail per criterion
- Issue severity ratings
- Specific corrections needed
- Overall compliance score
Validation Dimensions
Visual Identity
visual_checks: colors: - primary_colors_only: Verify only brand colors used - color_ratios: Check 60-30-10 rule - contrast_compliance: WCAG AA contrast logo: - correct_version: Right logo variant for context - clear_space: Minimum padding around logo - no_modifications: Logo not altered - proper_placement: Correct position typography: - approved_fonts: Only brand typefaces - hierarchy: Proper heading structure - minimum_sizes: Legible font sizes - line_spacing: Adequate line height imagery: - style_consistency: Matches brand aesthetic - quality_standards: Resolution requirements - diversity_representation: Inclusive imagery
Verbal Identity
verbal_checks: tone: - voice_consistency: Matches brand voice profile - formality_level: Appropriate for channel - personality_traits: Brand personality evident terminology: - approved_terms: Using brand glossary - product_names: Correct product naming - banned_phrases: No prohibited language messaging: - value_prop_alignment: Core messages present - tagline_usage: Correct tagline application - call_to_action: On-brand CTAs grammar: - style_guide: AP/Chicago/Brand style - capitalization: Title case rules - punctuation: Consistent punctuation
Legal Compliance
legal_checks: claims: - substantiation: Claims have evidence - comparative: Fair comparison rules - testimonials: Proper disclaimers disclosures: - required_statements: Mandatory disclosures - placement: Visible disclosure location - font_size: Legible disclosure text trademarks: - proper_symbols: ® and ™ usage - third_party: Licensed usage - no_infringement: No trademark violations privacy: - data_collection: Privacy notice present - consent: Opt-in mechanisms - cookies: Cookie notice if applicable
Accessibility
accessibility_checks: wcag: - contrast_ratio: Minimum 4.5:1 text, 3:1 UI - text_alternatives: Alt text for images - keyboard_navigation: Focusable elements - readable_text: No text in images inclusive: - plain_language: Readable content - color_independence: Info not color-only - responsive: Mobile accessible
Compliance Report Format
# Brand Compliance Report **Asset**: Summer Campaign Hero Banner **Date**: 2025-12-08 **Reviewer**: brand-compliance skill ## Summary | Dimension | Score | Status | |-----------|-------|--------| | Visual Identity | 95% | ✅ Pass | | Verbal Identity | 88% | ⚠️ Minor Issues | | Legal Compliance | 100% | ✅ Pass | | Accessibility | 75% | ⚠️ Needs Attention | | **Overall** | **90%** | **Conditional Pass** | ## Visual Identity ### ✅ Colors - Primary blue (#0066CC) used correctly - Secondary green (#00AA55) in accent areas - No off-brand colors detected ### ✅ Logo - Correct horizontal logo version - Clear space maintained (1x height) - No modifications to logo ### ⚠️ Typography - **Issue**: Body text uses Arial instead of Inter - **Severity**: Medium - **Fix**: Replace Arial with Inter Regular ## Verbal Identity ### ✅ Tone - Voice consistent with "Friendly Professional" profile - Appropriate formality for social media channel ### ⚠️ Terminology - **Issue**: "Best-in-class" used (prohibited phrase) - **Severity**: High - **Fix**: Replace with specific benefit statement ### ✅ Messaging - Value proposition clearly stated - CTA "Start Free Trial" is on-brand ## Legal Compliance ### ✅ Claims - All claims substantiated - No comparative claims ### ✅ Disclosures - Trademark symbols present - Terms link visible ## Accessibility ### ⚠️ Contrast - **Issue**: White text on light blue (3.2:1 ratio) - **Severity**: High - **Fix**: Darken background or use darker text - **Standard**: WCAG AA requires 4.5:1 ### ❌ Alt Text - **Issue**: Hero image missing alt text - **Severity**: High - **Fix**: Add descriptive alt text ## Required Corrections | Priority | Issue | Location | Fix | |----------|-------|----------|-----| | High | Low contrast | Hero text | Darken background | | High | Missing alt text | Hero image | Add alt attribute | | High | Banned phrase | Body copy | Replace "best-in-class" | | Medium | Wrong font | Body text | Use Inter, not Arial | ## Approval Status **Status**: CONDITIONAL APPROVAL Asset may proceed after addressing: - [ ] High-priority accessibility issues - [ ] Banned phrase removal Re-review recommended after corrections.
Usage Examples
Full Brand Review
User: "Brand review for the new landing page" Skill validates: 1. Visual: colors, logo, typography 2. Verbal: tone, terms, messaging 3. Legal: claims, disclosures, trademarks 4. Accessibility: contrast, alt text Output: "Brand Compliance: 90% (Conditional Pass) Issues Found: - High: Low contrast ratio (3.2:1, need 4.5:1) - High: Missing alt text on 2 images - Medium: Body font incorrect Report: .aiwg/marketing/reviews/brand-landing-page.md"
Quick Tone Check
User: "Is this copy on-brand?" Skill analyzes: - Voice consistency - Terminology - Messaging alignment Output: "Tone Analysis: ✅ On-brand Voice: Friendly Professional (matches profile) Terminology: All approved terms Messaging: Value prop present One suggestion: CTA could be more action-oriented"
Legal Review Focus
User: "Check claims compliance" Skill validates: - Claim substantiation - Comparative statements - Required disclosures Output: "Claims Compliance: ⚠️ Issues Found - Claim 'fastest in industry' needs substantiation - Missing source citation for statistics - Disclosure font too small (8pt, need 10pt)"
Integration
This skill uses:
: Launch Brand Guardian + Legal + Accessibilityparallel-dispatch
: Load brand voice profile for tone validationvoice-framework
: Find brand guidelines locationproject-awareness
Agent Orchestration
agents: visual_review: agent: brand-guardian focus: Visual identity validation verbal_review: agent: brand-guardian focus: Verbal identity and tone legal_review: agent: legal-reviewer focus: Claims, disclosures, trademarks accessibility_review: agent: accessibility-checker focus: WCAG compliance, inclusive design quality_check: agent: quality-controller focus: Technical specs, rendering
Configuration
Brand Guidelines Location
brand_config: guidelines_dir: .aiwg/marketing/brand/ voice_profile: .aiwg/voices/brand-voice.yaml color_palette: brand/colors.yaml typography: brand/typography.yaml logo_specs: brand/logo-usage.md terminology: brand/glossary.yaml banned_phrases: brand/banned-phrases.yaml
Severity Thresholds
severity: blocking: - trademark_violation - missing_required_disclosure - wcag_level_a_failure high: - banned_phrase - contrast_below_aa - missing_alt_text - wrong_logo_version medium: - wrong_font - color_off_palette - tone_inconsistency low: - minor_spacing - style_preference
Output Locations
- Compliance report:
.aiwg/marketing/reviews/brand-{asset}-{date}.md - Issue tracker:
.aiwg/marketing/reviews/brand-issues.json - Approval records:
.aiwg/marketing/approvals/
References
- Brand guidelines: .aiwg/marketing/brand/
- Voice profiles: voice-framework addon
- WCAG guidelines: https://www.w3.org/WAI/WCAG21/quickref/
- Templates: templates/governance/brand-compliance-checklist.md