Skip to content

AgriciDaniel/claude-ads / ads

Operate professional paid advertising across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for account intake, source-grounded audits, strategy, budget and measurement planning, creative production, experiments, reporting, monitoring, and explicitly approved campaign changes. Also trigger on PPC, paid social, retail media, attribution, tracking, landing pages, cross-platform conversion totals, negative keywords or search terms, beta-feature scoring, stale platform claims, API-token or credential setup, campaign deletion, and safe Claude Ads installation or uninstall.

FileKindSize
SKILL.mdskill md19.4 KB
agents/openai.yamlconfig205 B
references/additional-platforms.mdmarkdown3.1 KB
references/amazon-audit.mdmarkdown3.8 KB
references/apple-audit.mdmarkdown4.4 KB
references/automation-tier-classifier.mdmarkdown3.4 KB
references/benchmarks.mdmarkdown4.4 KB
references/bidding-strategies.mdmarkdown4.9 KB
references/budget-allocation.mdmarkdown4.2 KB
references/compliance-requirements.mdmarkdown6.2 KB
references/compliance.mdmarkdown5.0 KB
references/conversion-tracking.mdmarkdown6.9 KB
references/copy-frameworks.mdmarkdown4.1 KB
references/creative-source-registry.mdmarkdown2.0 KB
references/gaql-notes.mdmarkdown7.5 KB
references/google-audit.mdmarkdown26.1 KB
references/google-creative-specs.mdmarkdown2.2 KB
references/image-providers.mdmarkdown5.0 KB
references/linkedin-audit.mdmarkdown11.8 KB
references/linkedin-creative-specs.mdmarkdown1.8 KB
references/mcp-integration.mdmarkdown6.5 KB
references/meta-ai-stack.mdmarkdown4.9 KB
references/meta-audit.mdmarkdown17.8 KB
references/meta-creative-specs.mdmarkdown1.9 KB
references/microsoft-audit.mdmarkdown10.4 KB
references/microsoft-creative-specs.mdmarkdown1.8 KB
references/pinterest-audit.mdmarkdown4.2 KB
references/platform-specs.mdmarkdown5.2 KB
references/prompt-patterns.mdmarkdown3.4 KB
references/reddit-audit.mdmarkdown4.7 KB
references/scoring-system.mdmarkdown5.8 KB
references/snapchat-audit.mdmarkdown4.1 KB
references/status-contract.mdmarkdown773 B
references/thinking-framework.mdmarkdown13.7 KB
references/tiktok-audit.mdmarkdown11.4 KB
references/tiktok-creative-specs.mdmarkdown2.0 KB
references/voice-to-style.mdmarkdown4.0 KB
references/x-audit.mdmarkdown3.3 KB
references/youtube-audit.mdmarkdown4.5 KB
references/youtube-creative-specs.mdmarkdown2.0 KB

references/prompt-patterns.md

View on GitHub
# Claude Ads prompt patterns

These original examples specify routing, worker contracts, uncertainty, and
mutation safety. Use them when behavior is subtle; do not load them for simple
calculations or a clearly routed platform question.

## 1. Route by intended artifact

User: “Use this product photo to make four Meta ad concepts.”

- Route to `ads-create` when the user needs concepts, messaging, hooks, or briefs.
- Route to `ads-generate` only when a validated brief exists and image files are
  requested.
- Route to `ads-photoshoot` when the primary request is product-photography
  transformation rather than composed advertising concepts.
- If the request includes both concept and rendering, run create, obtain approval,
  then generate. Do not skip the intermediate manifest.

## 2. Bounded platform worker

```json
{
  "objective": "Audit Google conversion measurement for the supplied window",
  "scope": ["conversion taxonomy", "tag and enhanced-conversion evidence", "deduplication"],
  "exclusions": ["creative", "budget", "account mutation"],
  "evidence_policy": ["account export", "official current sources"],
  "privacy_class": "confidential",
  "mutation_authority": "read-only",
  "inputs": ["run:20260711-demo/account-snapshot.json"],
  "output_contract": "Finding[] v1.0.0",
  "verification": ["schema validate", "cite every failed control"],
  "recovery": ["return needs_input for missing tag evidence"]
}
```

The worker returns findings and recovery hints to the conductor. It does not write
`google-audit-results.md`, calculate a platform score, or broaden into budget work.

## 3. Missing evidence

User: “My Meta CPA doubled. Pause the worst ads.”

If the supplied data lacks conversion lag, attribution definition, spend, sample
size, recent changes, or current remote state:

1. Record the observed CPA change only if windows are comparable.
2. Return `needs_input` for a mutation.
3. Offer a read-only diagnostic and an explicit data request.
4. Do not apply a fixed CPA multiple or infer that the worst observed ad caused the
   account-level change.

## 4. Approved mutation

An approval is valid only for the exact mutation plan presented:

```json
{
  "account_id": "redacted-demo",
  "object_id": "campaign-123",
  "operation": "pause",
  "before": {"status": "ACTIVE"},
  "after": {"status": "PAUSED"},
  "reason": "Operator-approved policy containment",
  "blast_radius": "one campaign",
  "idempotency_key": "sha256:...",
  "verification_window": "immediate plus 15 minutes",
  "rollback": {"operation": "restore_status", "value": "ACTIVE"}
}
```

If remote state no longer matches `before`, stop and regenerate the plan. Approval
for one campaign, budget, or date never transfers to another.

## 5. Research and independent verification

The research worker proposes source records and affected claims. A separate source
verifier checks authority, date, scope, geography, methodology, license, and
claim-to-source fit. Only then may the conductor update canonical references and
tests. A community post can create a research lead; it cannot establish an official
API or policy claim.

## 6. Partial full audit

If Google, Meta, and tracking succeed but the requested Amazon worker fails
authentication:

- Preserve the successful platform results.
- Mark the bundle `partial`.
- Exclude Amazon from numerical portfolio health and display its missing weight.
- Return the authentication recovery step.
- Never title the deliverable “complete multi-platform audit.”
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall