Codex

brand-audit

Project directory path (default current directory)

104 stars

Best use case

brand-audit is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

It is a strong fit for teams already working in Codex.

Project directory path (default current directory)

Teams using brand-audit should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/brand-audit/SKILL.md --create-dirs "https://raw.githubusercontent.com/jmagly/aiwg/main/.agents/skills/brand-audit/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/brand-audit/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How brand-audit Compares

Feature / Agentbrand-auditStandard Approach
Platform SupportCodexLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Project directory path (default current directory)

Which AI agents support this skill?

This skill is designed for Codex.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Brand Audit Command

Conduct comprehensive brand health audit across all marketing touchpoints and materials.

## What This Command Does

1. **Audits Brand Identity**
   - Visual identity consistency
   - Verbal identity alignment
   - Brand guideline compliance

2. **Reviews Touchpoints**
   - Digital presence
   - Marketing materials
   - Customer communications

3. **Provides Recommendations**
   - Compliance gaps
   - Brand evolution opportunities
   - Action priorities

## Orchestration Flow

```
Brand Audit Request
        ↓
[Brand Guardian] → Visual Identity Audit
        ↓
[Brand Guardian] → Verbal Identity Audit
        ↓
[Positioning Specialist] → Positioning Review
        ↓
[Quality Controller] → Touchpoint Review
        ↓
[Marketing Analyst] → Brand Metrics
        ↓
[Reporting Specialist] → Audit Report
        ↓
Brand Audit Complete
```

## Agents Involved

| Agent | Role | Output |
|-------|------|--------|
| Brand Guardian | Lead audit | Compliance review |
| Positioning Specialist | Positioning | Positioning analysis |
| Quality Controller | Quality | Touchpoint review |
| Marketing Analyst | Metrics | Brand health data |
| Reporting Specialist | Reporting | Audit report |

## Audit Areas

| Area | Key Checks |
|------|------------|
| Visual | Logo, colors, typography, imagery |
| Verbal | Voice, tone, messaging, taglines |
| Digital | Website, social, email, ads |
| Print | Collateral, signage, packaging |
| Experience | Customer touchpoints |

## Output Artifacts

Saved to `.aiwg/marketing/brand/audit/`:

- `brand-audit-report.md` - Comprehensive audit
- `visual-audit.md` - Visual identity review
- `verbal-audit.md` - Verbal identity review
- `touchpoint-matrix.md` - All touchpoints
- `compliance-scorecard.md` - Compliance scores
- `gap-analysis.md` - Identified gaps
- `recommendations.md` - Action plan
- `brand-health-metrics.md` - Brand health data

## Parameter Handling

### --guidance Parameter

**Purpose**: Provide upfront direction to tailor priorities and approach

**Examples**:
```bash
--guidance "Comprehensive audit before rebrand"
--guidance "Focus on digital touchpoints"
--guidance "Competitive comparison with top 3 competitors"
```

**How Applied**:
- Parse guidance for keywords: priority, timeline, audience, focus, constraints
- Adjust agent emphasis and output depth based on stated priorities
- Modify deliverable order based on timeline constraints
- Influence scope and detail level based on context

### --interactive Parameter

**Purpose**: Guide through discovery questions for comprehensive input

**Questions Asked** (if --interactive):
1. What is the scope of the audit?
2. Are there specific touchpoints to prioritize?
3. What triggered this audit?
4. What comparisons should be included?
5. What is the timeline for completion?

## Usage Examples

```bash
# Full brand audit
/brand-audit --audit-scope full

# Visual identity only
/brand-audit --audit-scope visual

# Specific touchpoints
/brand-audit --audit-scope touchpoints

# With strategic guidance
/brand-audit "Example" --guidance "Your specific context here"

# Interactive mode
/brand-audit "Example" --interactive
```

## Success Criteria

- [ ] All brand elements audited
- [ ] Touchpoints reviewed
- [ ] Compliance scored
- [ ] Gaps identified
- [ ] Recommendations prioritized
- [ ] Action plan created

## References

- @$AIWG_ROOT/agentic/code/frameworks/media-marketing-kit/README.md — Media marketing kit framework overview
- @$AIWG_ROOT/agentic/code/addons/voice-framework/README.md — Voice framework for verbal identity evaluation
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/subagent-scoping.md — Multi-agent audit orchestration
- @$AIWG_ROOT/docs/cli-reference.md — CLI reference

Related Skills

security-audit

104
from jmagly/aiwg

Perform comprehensive security assessment

Codex

research-quality-audit

104
from jmagly/aiwg

Audit research corpus for shallow stubs, incomplete sections, missing source files, and doc depth issues. Detects docs written from abstracts rather than full papers and optionally auto-dispatches expansion agents.

Codex

cleanup-audit

104
from jmagly/aiwg

Audit codebase for dead code, unused exports, orphaned files, and stale manifests

Codex

brand-review

104
from jmagly/aiwg

Project directory path (default current directory)

Codex

brand-identity-refinement

104
from jmagly/aiwg

Refine brand identity through metaphor testing, competitive research, and owner-grounded verification tied to repository reality

Codex

brand-compliance

104
from jmagly/aiwg

Validate brand compliance across visual, verbal, and legal dimensions with actionable reports

Codex

aiwg-orchestrate

104
from jmagly/aiwg

Route structured artifact work to AIWG workflows via MCP with zero parent context cost

venv-manager

104
from jmagly/aiwg

Create, manage, and validate Python virtual environments. Use for project isolation and dependency management.

pytest-runner

104
from jmagly/aiwg

Execute Python tests with pytest, supporting fixtures, markers, coverage, and parallel execution. Use for Python test automation.

vitest-runner

104
from jmagly/aiwg

Execute JavaScript/TypeScript tests with Vitest, supporting coverage, watch mode, and parallel execution. Use for JS/TS test automation.

eslint-checker

104
from jmagly/aiwg

Run ESLint for JavaScript/TypeScript code quality and style enforcement. Use for static analysis and auto-fixing.

repo-analyzer

104
from jmagly/aiwg

Analyze GitHub repositories for structure, documentation, dependencies, and contribution patterns. Use for codebase understanding and health assessment.