---
name: freewheel-creative-validator
description: "Validate FreeWheel creative format, metadata, mapping, and compliance."
version: 2.0.0
author: Hermes Agent (rebuild)
license: Proprietary site content
platforms: [linux, macos, windows]
metadata:
  hermes:
    tags: [FreeWheel, Implementation, QA, Operations]
    related_skills: []
---

# SKILL.md — FreeWheel Creative Validator

## Purpose

Validate ad creatives against FreeWheel requirements — sizing, format,
compliance, targeting metadata, and line-item mapping. Checks creatives
before insertion and flags issues that would cause rejection.

---

## Scope

- Creative sizing validation (banner, video, overlay, companion)
- Format compliance (HTML5, VAST, video codecs)
- Targeting metadata validation
- Line-item mapping verification
- Compliance rules (brand safety, content restrictions)
- Pre-insertion validation checks

---

## Usage

### Validate Creative

```
Validate creative {creative_id} against {line_item}
```

### Check Compliance

```
Check creative compliance for {creative_id} — brand safety, content rules
```

### Fix Issues

```
Auto-fix creative issues for {creative_id} (confirm before applying)
```

### Generate Validation Report

```
Generate creative validation report for {creative_list}
```

---

## Core Commands

| Task | Command |
|---|---|
| Size Check | Validate creative dimensions against line-item specs |
| Format Check | Validate format (HTML5, VAST, video codecs) |
| Metadata Check | Validate targeting metadata, geo, demographic tags |
| Line-item Mapping | Verify creative linked to correct line-item |
| Compliance Check | Check brand safety rules, content restrictions |
| Pre-insertion Check | Run full validation before campaign launch |
| Report Export | Export validation report in requested format |

---

## Output Format

Reports should include:
- Validation status (pass, fail, warning)
- Issue list with severity and fix instructions
- Creative dimensions vs. required dimensions
- Format compliance status
- Metadata completeness score
- Line-item mapping accuracy
- Recommended corrections

---

## Configuration

- Default validation: full check (size, format, metadata, mapping, compliance)
- Override validation scope when specified
- Compliance rules sourced from FreeWheel brand safety guidelines
- Creative formats: HTML5 banner, VAST video, overlay, companion

---

## Notes

- Always validate before campaign launch — never skip pre-insertion check
- Critical issues (format mismatch, size error) block insertion
- Warnings (metadata incomplete) may allow insertion but flag for review
- Creative fixes require client-side coordination for updates
- Validation reports should be client-ready for review

## Inputs and Boundaries

- Require the account, environment, campaign or integration identifiers, requested operation, date range, and applicable platform specification.
- Default to read-only inspection or sandbox execution. Require explicit approval before production changes, automation writes, DNS changes, inventory changes, or launch actions.
- Validate user-provided URLs, XML, files, identifiers, and configuration before processing.
- Never expose credentials, tokens, client secrets, or unnecessary PII in logs, reports, test fixtures, or generated artifacts.

## Failure Handling

- Record the exact input, environment, operation, timestamp, response, and correlation ID when available.
- Classify failures as malformed input, unsupported format, authentication, permission, dependency, timeout, platform, or verification failure.
- Do not repeat mutations blindly. Check for partial completion and current state before retrying.
- Stop and escalate when a production, security, compliance, delivery, or rollback gate fails.

## Verification

- Confirm every requested item was checked and report pass, fail, or warning per item.
- Read back the authoritative configuration after approved changes.
- Run the relevant sandbox, integration, delivery, playback, routing, or health check.
- Preserve evidence and report assumptions, approvals, unresolved risks, rollback status, and next actions.