agents-united 0.5.0

package/registry/skills/marketing-creative-design/SKILL.md

@@ -0,0 +1,186 @@
+---
+name: marketing-creative-design
+description: Production-grade Marketing Creative Design playbook for
+  multi-channel ad creative layouts, visual hierarchy, aspect ratio adaptation,
+  brand asset generation, and export optimization.
+metadata:
+  author: agents-united
+  version: 2.0.0
+  icon: 🎨
+disable-slash-command: true
+---
+
+# Marketing Creative Design & Multi-Channel Visual Asset Generation
+
+## Overview & Purpose
+The Marketing Creative Design skill provides a deterministic framework for generating high-converting visual advertising creatives, banner layouts, social media visual assets, typography scales, color palettes, and responsive multi-aspect ratio asset packages (1:1 square, 9:16 vertical stories/reels, 16:9 widescreen landscape, 4:5 mobile feed portrait).
+
+Following this skill ensures strict brand guideline adherence, visual hierarchy compliance, WCAG contrast accessibility, and automated multi-channel export optimization (WebP, AVIF, SVG, PNG).
+
+## Execution Triggers & Prerequisites
+### Execution Triggers
+- Request to design multi-channel ad creative suites (Meta, Google Display, LinkedIn, Twitter/X, TikTok).
+- Generating responsive banner ad variants and hero visual graphics.
+- Creating standardized brand asset kits and typography/color design tokens for marketing campaigns.
+- Exporting, compressing, and formatting creative visual assets for production ad deployment.
+
+### Prerequisites
+- Brand identity guidelines (color tokens, font families, logo vector files).
+- Campaign messaging, headline copy, value proposition hooks, and primary call-to-action (CTA).
+- Asset processing tooling operational (Sharp, Squoosh, Canvas/SVG generators, Figma tokens).
+- Clean git working directory.
+
+## Input & Output Requirements
+### Inputs
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `campaign_name` | String | Yes | Unique campaign or experiment identifier |
+| `target_aspect_ratios` | Array<String> | Yes | Target ratios: `['1:1', '9:16', '16:9', '4:5']` |
+| `headline_hook` | String | Yes | Primary hook headline text for creative display |
+| `cta_text` | String | Yes | Button label (e.g. "Start Free Trial", "Book Demo") |
+| `brand_tokens` | Object | Optional | Color hex codes, typography scale, logo paths |
+| `output_format` | String | Optional | Desired export format (`webp`, `avif`, `png`, `svg`) |
+
+### Outputs
+| Artifact | Path / Format | Description |
+|---|---|---|
+| Creative Brief Spec | `docs/marketing-creative-design/creative-brief.md` | Full design specification and layout rules |
+| Generated Assets | `assets/creatives/<campaign>/*` | Multi-aspect ratio image and vector assets |
+| Asset Manifest | `reports/marketing-creative-design/manifest.json` | Dimension, aspect ratio, and file size index |
+| Visual Audit Report | `reports/marketing-creative-design/audit.json` | Contrast ratio, safe-zone, and file size checks |
+
+## Step-by-Step Execution Runbook
+
+### Phase 1: Creative Brief Analysis & Visual Architecture
+1. Ingest campaign goals, target buyer persona, and core value proposition.
+2. Select visual layout archetype (Hero Product Showcase, Split Comparison, Social Proof Badge, Bold Typography Hook).
+3. Establish color palette hierarchy: 60% dominant canvas, 30% structural contrast, 10% high-contrast accent for CTA.
+4. Verify typography hierarchy (Headline > Subheadline > Benefit Bullets > CTA Button > Microcopy/Legal).
+5. Inspect repository asset directories to locate existing brand vectors and font files.
+   ```bash
+   find assets/ -type f -name "*.svg" -o -name "*.png"
+   ```
+
+### Phase 2: Design Token & Aspect Ratio Grid Layout Setup
+1. Define aspect ratio canvas dimensions:
+   - 1:1 Feed Square: 1080 x 1080 px
+   - 9:16 Vertical Stories / Reels / TikTok: 1080 x 1920 px (Safe zone: top 250px, bottom 350px clear)
+   - 16:9 Widescreen Display / YouTube: 1920 x 1080 px (or 1200 x 628 px for Google Display)
+   - 4:5 Mobile Feed Portrait: 1080 x 1350 px
+2. Configure layout grid margins (minimum 64px padding on mobile, 96px on desktop displays).
+3. Set up responsive text scaling curves to ensure headline readability across mobile viewports.
+4. Establish focal point safe zones to prevent platform UI overlay clipping (profile icons, audio badges, CTA bars).
+
+### Phase 3: Visual Asset Composition & Multi-Variant Generation
+1. Compose base vector or canvas layout applying design system tokens.
+2. Render headline typography with strict line-height and kerning adjustments.
+3. Position primary brand mark/logo in top-left or top-center anchor with minimum clear space.
+4. Insert hero imagery or product mockups with calibrated drop shadows and elevation depth.
+5. Render high-contrast CTA pill button with accessible foreground/background color combinations.
+6. Generate multi-variant creative matrices testing 3 headline angles against 2 background styles (6 variants total).
+
+### Phase 4: Contrast Auditing, File Optimization & Export Encoding
+1. Execute automated WCAG AA/AAA contrast check between text elements and background layers (minimum 4.5:1 ratio).
+2. Run image compression pipeline targeting optimal delivery sizes:
+   - Display Ads: < 150 KB
+   - Social Feed Creatives: < 1.5 MB (lossless WebP/PNG)
+3. Convert master vector graphics into optimized WebP and high-density 2x PNG assets.
+   ```bash
+   node scripts/optimize-creatives.js --input assets/creatives/raw --output assets/creatives/dist
+   ```
+4. Verify image dimensions, color profiles (sRGB), and metadata strip compliance.
+
+### Phase 5: Manifest Compilation & Asset Review Handoff
+1. Compile generated creative manifest indexing filenames, dimensions, aspect ratios, file sizes, and checksums.
+2. Generate visual review sheet at `docs/marketing-creative-design/creative-brief.md`.
+3. Verify zero broken image references or missing aspect ratio variants.
+4. Commit validated creative assets to git repository.
+   ```bash
+   git add assets/creatives/ docs/marketing-creative-design/
+   git commit -m "feat(marketing-creative-design): generate multi-channel creative asset suite"
+   ```
+5. Hand off creative assets to paid acquisition and campaign execution teams.
+
+## Code & Configuration Exemplars
+
+### Exemplar 1: Multi-Aspect Ratio Creative Layout Specification
+```yaml
+version: "2.0.0"
+campaign: "q3-enterprise-saas-launch"
+brand:
+  colors:
+    primary: "#0F172A"
+    accent: "#3B82F6"
+    cta: "#10B981"
+    background: "#F8FAFC"
+  typography:
+    headlineFont: "Inter, sans-serif"
+    weight: 800
+variants:
+  - ratio: "1:1"
+    width: 1080
+    height: 1080
+    safeZone: { top: 64, bottom: 64, left: 64, right: 64 }
+    layout: "center-stacked"
+  - ratio: "9:16"
+    width: 1080
+    height: 1920
+    safeZone: { top: 250, bottom: 350, left: 80, right: 80 }
+    layout: "vertical-flow"
+  - ratio: "16:9"
+    width: 1920
+    height: 1080
+    safeZone: { top: 80, bottom: 80, left: 120, right: 120 }
+    layout: "split-horizontal"
+```
+
+### Exemplar 2: TypeScript Programmatic Creative Asset Generator
+```typescript
+export interface CreativeAssetSpec {
+  campaign: string;
+  variantId: string;
+  aspectRatio: '1:1' | '9:16' | '16:9' | '4:5';
+  width: number;
+  height: number;
+  headline: string;
+  ctaText: string;
+}
+
+export function compileCreativeManifest(specs: CreativeAssetSpec[]): Record<string, any> {
+  return {
+    generatedAt: new Date().toISOString(),
+    totalVariants: specs.length,
+    assets: specs.map(spec => ({
+      id: `${spec.campaign}-${spec.variantId}-${spec.aspectRatio.replace(':', 'x')}`,
+      dimensions: `${spec.width}x${spec.height}`,
+      ratio: spec.aspectRatio,
+      exportPath: `assets/creatives/${spec.campaign}/${spec.variantId}-${spec.aspectRatio.replace(':', 'x')}.webp`,
+    })),
+  };
+}
+```
+
+## Edge Cases & Error Recovery Procedures
+
+### Scenario A: Text Safe-Zone Violation on Vertical 9:16 Assets
+1. **Diagnosis**: Headline copy or CTA button overlaps with platform UI overlays (TikTok sound icon, Instagram profile footer).
+2. **Recovery Protocol**:
+   - Step 1: Detect bounding box coordinates of text and CTA layers against safe-zone boundaries (top 250px, bottom 350px).
+   - Step 2: Recalculate vertical flow offset and clamp text positioning inside the 1320px central vertical window.
+   - Step 3: Re-render vertical 9:16 asset variant and re-verify bounding box clearance.
+
+### Scenario B: Creative File Size Exceeds Ad Network Limit
+1. **Diagnosis**: Exported display creative exceeds network constraint (e.g. Google Display Ad limit of 150 KB).
+2. **Recovery Protocol**:
+   - Step 1: Analyze image compression parameters and color depth.
+   - Step 2: Apply adaptive lossy WebP compression with quality step degradation (85 -> 80 -> 75).
+   - Step 3: Strip extraneous EXIF metadata and re-encode to confirm file size <= 150 KB.
+
+## Verification & Validation Checklist
+- [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
+- [ ] All 7 mandatory sections present with explicit headers.
+- [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
+- [ ] Multi-aspect ratios (1:1, 9:16, 16:9, 4:5) defined with exact pixel grids and safe zones.
+- [ ] Code exemplars provided with valid syntax fencing.
+- [ ] Zero dummy placeholder strings or unpopulated template markers present.
+- [ ] Project build, test suite, and doctor check pass 100% cleanly.

package/registry/skills/mcp-setup/SKILL.md

@@ -0,0 +1,370 @@
+---
+name: mcp-setup
+description: Comprehensive setup, configuration, and hardening runbook for Model
+  Context Protocol (MCP) servers across all AI clients (Antigravity, Cursor,
+  Cline, Claude, OpenCode, Codex) in Fully Operational and Limited Operational
+  modes.
+metadata:
+  author: agents-united
+  version: 2.0.0
+  icon: 🔌
+---
+
+# MCP Server Setup & Multi-Client Hardening
+
+## Overview & Purpose
+The `mcp-setup` skill provides deterministic instructions, configuration templates, and hardening procedures for installing and managing Model Context Protocol (MCP) servers across all supported AI developer clients and runtime environments.
+
+It defines exact configuration patterns for:
+1. **Fully Operational Mode**: Authenticated with API keys/bearer tokens for unlimited cloud access, private repository mutations, and deep crawling.
+2. **Limited Operational Mode**: Unauthenticated, free-tier, local, or self-hosted configurations operating within public rate limits without external API keys.
+3. **Brainstorming / Native Fallback**: Seamless fallback to native workspace tools (`run_command` with git/curl, `grep_search`, `write_to_file`) when MCP servers are omitted.
+
+---
+
+## Supported Host Clients & Config Locations
+
+| AI Client / Host | Configuration File Path | Format / Provisioning Command |
+|---|---|---|
+| **Antigravity CLI / App** | `~/.gemini/antigravity/mcp/<serverName>` or `.gemini/antigravity/mcp/` | `agy mcp add <name> --type stdio|http --command <cmd> --args <args> --env KEY=VAL` |
+| **Cursor** | `.cursor/mcp.json` (Workspace) or `~/.cursor/mcp.json` (Global) | Standard JSON `{ "mcpServers": { ... } }` |
+| **Cline (VS Code)** | `cline_mcp_settings.json` (Workspace) or `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` | JSON with `"disabled": false, "autoApprove": []` |
+| **Claude Desktop** | `%APPDATA%/Claude/claude_desktop_config.json` (Win) / `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) | Standard JSON `{ "mcpServers": { ... } }` |
+| **Claude Code (CLI)** | `.claude/mcp.json` (Workspace) or `claude.json` | `claude mcp add <name> <command> [args...]` |
+| **OpenCode** | `opencode.json` or `.opencode/mcp.json` | `opencode mcp install <name>` |
+| **OpenAI Codex CLI** | `codex_config.json` (Workspace) | Injected via environment / stdio tool descriptors |
+
+---
+
+## MCP Server Matrix & Setup Modes
+
+### 1. GitHub MCP (`github`)
+- **Purpose**: Repository management, branch creation, pull request workflows, issue triage.
+- **Fully Operational (Auth)**:
+  ```json
+  "github": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-github"],
+    "env": {
+      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourPersonalAccessTokenHere"
+    }
+  }
+  ```
+- **Limited Operational (Unauthenticated)**:
+  ```json
+  "github": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-github"]
+  }
+  ```
+  *(Allows querying public repositories, issues, and releases subject to GitHub unauthenticated IP rate limit of 60 req/hr).*
+- **Fallback (No MCP)**: Agents use native Git CLI commands (`git status`, `git checkout -b`, `git commit`, `git push`) via `run_command`.
+
+---
+
+### 2. Firecrawl MCP (`firecrawl`)
+- **Purpose**: Deep web crawling, competitor SERP scraping, full-site markdown extraction.
+- **Fully Operational (Auth)**:
+  ```json
+  "firecrawl": {
+    "command": "npx",
+    "args": ["-y", "firecrawl-mcp"],
+    "env": {
+      "FIRECRAWL_API_KEY": "fc-yourFirecrawlApiKeyHere"
+    }
+  }
+  ```
+- **Limited Operational (Self-Hosted / Local Instance)**:
+  ```json
+  "firecrawl": {
+    "command": "npx",
+    "args": ["-y", "firecrawl-mcp"],
+    "env": {
+      "FIRECRAWL_API_URL": "http://localhost:3002"
+    }
+  }
+  ```
+  *(Connects to a local open-source Firecrawl Docker container running on localhost).*
+- **Fallback (No MCP)**: Agents use `curl` / `fetch` or static mock market models via `run_command`.
+
+---
+
+### 3. Context7 MCP (`context7`)
+- **Purpose**: Up-to-date documentation retrieval, framework library resolution.
+- **Fully Operational (Auth)**:
+  ```json
+  "context7": {
+    "command": "npx",
+    "args": ["-y", "@upstash/context7-mcp"],
+    "env": {
+      "UPSTASH_REDIS_REST_URL": "https://your-upstash-url.upstash.io",
+      "UPSTASH_REDIS_REST_TOKEN": "your-upstash-token"
+    }
+  }
+  ```
+- **Limited Operational (Unauthenticated Public Mode)**:
+  ```json
+  "context7": {
+    "command": "npx",
+    "args": ["-y", "@upstash/context7-mcp"]
+  }
+  ```
+  *(Queries public cached library docs without persistent user storage).*
+- **Fallback (No MCP)**: Agents search local markdown documentation and codebase types via `grep_search` and `view_file`.
+
+---
+
+### 4. Playwright MCP (`playwright`)
+- **Purpose**: Headless browser automation, visual snapshotting, CRO conversion funnel testing.
+- **Fully & Limited Operational (Local Node Runner - No API Key Required)**:
+  ```json
+  "playwright": {
+    "command": "npx",
+    "args": ["-y", "@executeautomation/playwright-mcp-server"]
+  }
+  ```
+- **Fallback (No MCP)**: Agents run Playwright scripts via terminal (`npx playwright test`) using `run_command`.
+
+---
+
+### 5. MarkItDown MCP (`markitdown`)
+- **Purpose**: High-fidelity document conversion (PDF, DOCX, PPTX, XLSX, HTML) to clean Markdown.
+- **Fully & Limited Operational (Local Python/Node CLI - No API Key Required)**:
+  ```json
+  "markitdown": {
+    "command": "uvx",
+    "args": ["markitdown-mcp"]
+  }
+  ```
+  *Alternative via Python*:
+  ```json
+  "markitdown": {
+    "command": "python",
+    "args": ["-m", "markitdown_mcp"]
+  }
+  ```
+- **Fallback (No MCP)**: Agents ingest plain text or markdown directly.
+
+---
+
+### 6. Chrome DevTools MCP (`chrome-devtools-mcp`)
+- **Purpose**: Live DOM inspection, Core Web Vitals profiling (LCP, CLS, FID), network tracing.
+- **Fully & Limited Operational (Local Chrome Instance - No API Key Required)**:
+  ```json
+  "chrome-devtools-mcp": {
+    "command": "npx",
+    "args": ["-y", "chrome-devtools-mcp"]
+  }
+  ```
+  *Requires Chrome launched with remote debugging port*: `chrome.exe --remote-debugging-port=9222`.
+- **Fallback (No MCP)**: Agents run static Lighthouse audits or bundle analyzers.
+
+---
+
+### 7. Google Stitch MCP (`stitch`)
+- **Purpose**: AI visual UI generation, canvas rendering, design token construction.
+- **Fully Operational (Auth)**:
+  ```json
+  "stitch": {
+    "command": "npx",
+    "args": [
+      "-y",
+      "mcp-remote",
+      "https://stitch.googleapis.com/mcp",
+      "--header",
+      "X-Goog-Api-Key: your-google-stitch-api-key"
+    ]
+  }
+  ```
+- **Limited Operational (Unauthenticated / Remote Endpoint)**:
+  ```json
+  "stitch": {
+    "command": "npx",
+    "args": ["-y", "mcp-remote", "https://stitch.googleapis.com/mcp"]
+  }
+  ```
+- **Fallback (No MCP)**: Agents generate Tailwind CSS / HTML / React code directly in workspace files.
+
+---
+
+### 8. Figma MCP (`figma`)
+- **Purpose**: Design system token extraction, canvas layout inspection, asset exports.
+- **Fully Operational (Auth)**:
+  ```json
+  "figma": {
+    "command": "npx",
+    "args": ["-y", "ai-figma-mcp"],
+    "env": {
+      "FIGMA_ACCESS_TOKEN": "figd_yourFigmaAccessTokenHere"
+    }
+  }
+  ```
+- **Limited Operational (Community Server)**:
+  ```json
+  "figma": {
+    "command": "npx",
+    "args": ["-y", "ai-figma-mcp"]
+  }
+  ```
+  "figma": {
+    "command": "npx",
+    "args": ["-y", "@modelcontextprotocol/server-figma"]
+  }
+  ```
+  *(Queries public Community files by file ID without private organization access).*
+- **Fallback (No MCP)**: Agents use local design tokens defined in `registry/skills/design-system-tokens`.
+
+---
+
+## Universal Multi-Client Configuration Templates
+
+### Cursor (`.cursor/mcp.json`)
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourToken"
+      }
+    },
+    "firecrawl": {
+      "command": "npx",
+      "args": ["-y", "firecrawl-mcp"],
+      "env": {
+        "FIRECRAWL_API_KEY": "fc_yourKey"
+      }
+    },
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-playwright"]
+    },
+    "markitdown": {
+      "command": "uvx",
+      "args": ["markitdown-mcp"]
+    },
+    "chrome-devtools-mcp": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp"]
+    },
+    "stitch": {
+      "command": "npx",
+      "args": ["-y", "@google/stitch-mcp"]
+    },
+    "figma": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-figma"],
+      "env": {
+        "FIGMA_ACCESS_TOKEN": "figd_yourToken"
+      }
+    }
+  }
+}
+```
+
+### Cline (`cline_mcp_settings.json`)
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourToken"
+      },
+      "disabled": false,
+      "autoApprove": []
+    },
+    "firecrawl": {
+      "command": "npx",
+      "args": ["-y", "firecrawl-mcp"],
+      "env": {
+        "FIRECRAWL_API_KEY": "fc_yourKey"
+      },
+      "disabled": false,
+      "autoApprove": []
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-playwright"],
+      "disabled": false,
+      "autoApprove": []
+    },
+    "chrome-devtools-mcp": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Claude Desktop (`claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourToken"
+      }
+    },
+    "firecrawl": {
+      "command": "npx",
+      "args": ["-y", "firecrawl-mcp"],
+      "env": {
+        "FIRECRAWL_API_KEY": "fc_yourKey"
+      }
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-playwright"]
+    }
+  }
+}
+```
+
+---
+
+## Step-by-Step Orchestrator Execution Runbook
+
+### Phase 1 — Host Discovery & Mode Detection
+1. Inspect the active environment and workspace configuration files (`.cursor/mcp.json`, `cline_mcp_settings.json`, `.gemini/antigravity/mcp/`, `claude_desktop_config.json`).
+2. Classify the execution envelope:
+   - **Fully Operational**: Target MCP servers present with valid auth tokens.
+   - **Limited Operational**: MCP servers present without auth tokens.
+   - **Brainstorming / Native Fallback**: Zero MCP servers configured.
+
+### Phase 2 — Guided Setup & User Choice
+1. If prerequisites are missing or unauthenticated, the Orchestrator presents an interactive choice to the user:
+   ```markdown
+   > [!NOTE]
+   > **MCP Tooling Setup Options**:
+   > 1. **Fully Operational**: Provide API keys (e.g. `FIRECRAWL_API_KEY`, `GITHUB_PERSONAL_ACCESS_TOKEN`) for full cloud capabilities.
+   > 2. **Limited Operational**: Run free/local MCP servers (Playwright, MarkItDown, Chrome DevTools, Context7) without API keys.
+   > 3. **Brainstorming Mode**: Use native workspace tools (`git`, `curl`, `write_to_file`) with zero MCP setup.
+   ```
+2. The user can switch modes anytime via `/mode operational`, `/mode limited-operational`, or `/mode brainstorming`.
+
+### Phase 3 — Provisioning & Validation
+1. If the user chooses to provision MCP servers, execute the corresponding client configuration or CLI commands:
+   ```bash
+   agy mcp add firecrawl --type stdio --command npx --args -y,firecrawl-mcp --env FIRECRAWL_API_KEY=fc_...
+   ```
+2. Validate server connectivity and report status in the session summary.
+
+---
+
+## Verification & Validation Checklist
+- [ ] Config paths match host OS conventions (Windows `%APPDATA%`, macOS `~/Library/Application Support`).
+- [ ] JSON blocks contain valid syntax with escaped quotes.
+- [ ] Both Fully Operational (with env vars) and Limited Operational (without env vars) configurations provided.
+- [ ] Fallback native tool alternatives documented for all 8 MCP servers.
+- [ ] Mode switching syntax (`/mode operational`, `/mode limited-operational`, `/mode brainstorming`) documented.

package/registry/skills/meta-ad-creative-testing/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: meta-ad-creative-testing
+description: Meta Ads creative testing frameworks, dynamic creative optimization
+  (DCO), video hook retention analysis, and scaling rules.
+metadata:
+  author: Agents United Performance Group
+  version: 1.0.0
+  license: MIT
+  icon: 🎨
+disable-slash-command: true
+---
+
+# Meta Ad Creative Testing Playbook
+
+## Overview & Purpose
+`meta-ad-creative-testing` guides performance marketers through structured creative testing frameworks on Facebook & Instagram Ads to discover breakout creative winners.
+
+## Core Directives & Standards
+1. **Dynamic Creative Testing (DCT)** — Test 3 creatives, 2 primary texts, and 2 headlines per sandbox ad set with broad audience targeting.
+2. **3-Second Hook Retention** — Analyze hook rate (3s video views ÷ impressions) and hold rate (15s views ÷ 3s views) to optimize video beginnings.
+3. **Scaling Protocols** — Move winning creative combinations (CPA below target for 3+ consecutive days) to CBO scaling campaigns.
+4. **Fatigue Monitoring** — Refresh visual assets when frequency exceeds 2.5 on prospecting campaigns or CPA spikes > 25%.
+
+## Verification Checklist
+- [ ] Meta Conversions API (CAPI) and Pixel events configured with Event Quality Match > 8.0.
+- [ ] Clear naming conventions tagging creative concept, angle, format, and date.