ad-copy-verification-standard
Skill72 starsChanged 4 months agoMITView on GitHub
Mandatory verification requirements for all ad copy creation (RSAs, extensions, callouts, structured snippets). Auto-invoke when generating ad copy. Enforces website-sourced claims only — no assumptions, no templates-as-content, no unverified placeholders. Core principle — Empty > Inaccurate.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- Vibha-Ramprakash/automate-google-adsword for word, first seen Sep 14, 2026
Other versions1 project uses a version of this.
Word for word · 1
- Vibha-Ramprakash/automate-google-ads★ 0100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository41 other files it gives its agents.
- account-diagnosticSkill
- ad-copy-generation-frameworkSkill
- add-account-negative-keywordsSkill
- ads-checkerSkill
- budget-guardianSkill
- budget-recommendation-calculatorSkill
- change-history-checkerSkill
- client-communication-standardsSkill
- competitor-analysis-v2Skill
- conversion-tracking-healthSkill
- dgen-automation-disableSkill
- fair-housing-complianceSkill
- ga4-campaign-cross-referenceSkill
- ga4-cross-analysisSkill
- ga4-lead-quality-investigationSkill
- gaql-query-patternsSkill
- geo-conflict-analyzerSkill
- google-ads-api-setupSkill
- google-ads-querySkill
- google-ads-samplesSkill
- impression-share-diagnosticsSkill
- investigation-methodologySkill
- lead-quality-pattern-analysisSkill
- lead-quality-recommendation-prioritizationSkill
- markdown-to-sheets-presenterSkill
- mcc-hack-auditSkill
- mutation-safetySkill
- neg-conflict-finderSkill
- non-serving-keyword-scannerSkill
- pmax-asset-automationSkill
- pmax-builderSkill
- portfolio-health-prioritizationSkill
- portfolio-pacing-rulesSkill
- rsa-bulk-editSkill
- rsa-refreshSkill
- rsa-single-accountSkill
- shared-budget-updaterSkill
- sqr-classifierSkill
- sqr-pipelineSkill
- underspending-investigationSkill
- youtube-placement-auditSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
24 rules. About 0 are common, 24 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈24
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 46
Before creating ANY ad copy (headlines, descriptions, callouts, structured snippets):
- Distinctive: line 55
Every piece of ad copy must have a source citation:
- Distinctive: line 71
If Firecrawl cannot access the website OR website has limited content:
- Distinctive: line 75
Only use existing account data (current ads, extensions)
- Distinctive: line 77
Create generic structural improvements only
- Distinctive: line 81
Use industry templates as content source
- Distinctive: line 128
No generic headlines without verification ("Great Service", "Quality Work")
- Distinctive: line 129
Use actual business differentiators from website
- Distinctive: line 132
Must reference verified services/features
- Distinctive: line 133
No generic value propositions without evidence
- Distinctive: line 164
Every callout must have website source
- Distinctive: line 165
No industry standard callouts without verification
- Distinctive: line 179
Only include services explicitly listed on website
- Distinctive: line 180
Do NOT add "common" services without verification
- Distinctive: line 184
Only include brands explicitly mentioned on website
- Distinctive: line 185
Do NOT infer brands from "all makes/models" language
- Distinctive: line 189
Only include vehicle types if explicitly mentioned
- Distinctive: line 251
Only use verified_claims for ad copy.
- Distinctive: line 285
Before submitting ANY ad copy to user:
- Distinctive: line 433
If website data is missing → use empty string
- Distinctive: line 434
If review data is missing → use empty string
- Distinctive: line 435
If warranty not found → use empty string
- Distinctive: line 436
NEVER substitute generic placeholders
- Distinctive: line 440
All RSA generation scripts should include a header reference:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Ad Copy Verification Standard
Purpose: Mandatory verification requirements for ALL ad copy creation (RSAs, extensions, callouts, etc.).
Type: Universal skill — auto-invoked for any ad copy generation task
Status: MANDATORY — All ad copy must follow this standard
What This Skill Deliberately Does NOT Do
- Generate the copy. Structure, distribution formulas, and copywriting craft live in
ad-copy-generation-framework— this standard only decides which claims are allowed in. - Scrape websites itself. It requires scraped site content (Firecrawl, Jina Reader, or any scraper returning clean markdown — see Rule 1) but ships no scraper.
- Check Google Ads policy. A claim can be fully verified and still disapproved (trademarks, restricted categories). Verification is factual grounding, not policy review.
- Judge performance. It never says whether verified copy will convert — only whether it's true to the website. Diagnosing underperforming copy is
investigation-methodology's territory.
Core Principle
ABSOLUTE REQUIREMENT: Only create ad copy based on EXPLICITLY VERIFIED information from the business's website.
NEVER create ad copy based on:
- ❌ "Common industry practices"
- ❌ "What most businesses do"
- ❌ Assumptions about services offered
- ❌ Template libraries used as source of truth
- ❌ Generic best practices without verification
- ❌ Generic placeholders or unverified ratings/counts
CRITICAL: This verification requirement applies to ALL ad copy elements - headlines, descriptions, CTAs, flexible headlines, and ALL other copy. No exceptions.
Universal Verification Rules
Rule 1: Website Verification is MANDATORY
Before creating ANY ad copy (headlines, descriptions, callouts, structured snippets):
- Scrape the website using Firecrawl
- Extract explicit claims, services, features, credentials
- Document source for each claim (which page, exact wording)
- Only use verified information in ad copy
Rule 2: Source Citation Required
Every piece of ad copy must have a source citation:
✅ CORRECT:
Headline: "ASE-Certified Technicians"
- Source: About page states "Our ASE-certified master technicians"
- Verified: YES
❌ WRONG:
Headline: "ASE-Certified Technicians"
- Reason: Most auto shops have ASE certification
- Verified: NO (ASSUMPTION)Rule 3: When Website Scraping Fails
If Firecrawl cannot access the website OR website has limited content:
DO:
- State limitation clearly to user
- Only use existing account data (current ads, extensions)
- Suggest manual website review by user
- Create generic structural improvements only
DO NOT:
- Guess at services/features
- Use industry templates as content source
- Make assumptions about business offerings
- Recommend unverified claims
Rule 4: Template Usage Guidelines
Templates are for FORMATTING, not CONTENT:
✅ Correct Use:
- Website says "family owned since 1986"
- Template suggests format: "Family-Owned Since 1986" (proper capitalization)
- Result: Use template formatting for verified claim
❌ Incorrect Use:
- Template has "Open Saturdays"
- Website doesn't mention Saturday hours
- Result: DO NOT add "Open Saturdays" just because template has it
Rule 5: "Free" Exclusion Rule
EXCLUDE any copy referring to "Free" - even if verified on the website:
❌ Prohibited (even if on website):
- "Free Estimates"
- "Get Your Free Quote Today!"
- "Free Diagnostics"
- "Free Inspections"
- "Free Consultation"
✅ Alternative Copy:
- "Get Your Quote Today!"
- "Request A Quote!"
- "Call For Your Estimate!"
- "Schedule Your Inspection!"
Reason: Targeting premium customers, not price-sensitive shoppers. "Free" copy attracts wrong customer avatar regardless of whether claim is true.
Application: This filter applies AFTER verification - first verify the claim exists on website, then exclude if it contains "Free".
Ad Copy Types - Specific Requirements
Responsive Search Ads (RSAs)
Headlines (15 max):
- Each headline must cite website source
- No generic headlines without verification ("Great Service", "Quality Work")
- Use actual business differentiators from website
Descriptions (4 max):
- Must reference verified services/features
- No generic value propositions without evidence
- Include verified CTAs only
Example Verification Process:
WRONG Approach:
"Let's add these common auto shop headlines:
- Expert Auto Repair (generic - no verification)
- Open 7 Days a Week (unverified assumption)
- Free Estimates (violates Rule 5 - no 'Free' copy)
- Rated 5★ By Happy Customers (generic placeholder - no source)"
RIGHT Approach:
"Website scrape results:
- Page: About - 'ASE-certified technicians since 1986'
- Page: Services - 'Specializing in diesel repair'
- Page: Contact - 'Monday-Friday 8AM-6PM'
- Page: Homepage - Customer testimonial: 'Best shop in town'
Verified Headlines:
- ASE-Certified Since 1986 (Source: About page)
- Diesel Repair Specialists (Source: Services page)
- Open Weekdays 8AM-6PM (Source: Contact page)
- \"Best Shop In Town\" - Customer (Source: Homepage testimonial)"Callout Extensions
Requirements:
- Maximum 25 characters
- Every callout must have website source
- No industry standard callouts without verification
Forbidden Without Verification:
- "Same Day Service"
- "Open Saturdays"
- "Lifetime Warranty"
- Any hours/amenities/services not explicitly stated
Forbidden Even WITH Verification (Rule 5):
- Any copy containing "Free" (estimates, quotes, diagnostics, etc.)
Structured Snippets
Service catalog header:
- Only include services explicitly listed on website
- Do NOT add "common" services without verification
- Minimum 3 services (from website only)
Brands header:
- Only include brands explicitly mentioned on website
- Do NOT infer brands from "all makes/models" language
- Need specific brand names stated
Types header:
- Only include vehicle types if explicitly mentioned
- Can infer basic types (Sedans, SUVs, Trucks) from "all vehicles" ONLY IF defensible
- Flag as "inferred" if not explicit
Sitelinks
Requirements:
- Link text must match actual page/service on website
- Description must reference verified content
- Landing page URL must exist and be relevant
Verification Workflow
Step 1: Website Discovery
Get the business website URL — either from the Google Ads account (query ad_group_ad.ad.final_urls) or from the user directly.
Step 2: Website Scraping
Scrape the site using Firecrawl, Jina Reader, or any scraper that returns clean markdown. The goal is structured claims you can cite.
Output includes:
- Services offered (explicit list)
- Credentials (ASE, BBB, NAPA, AAA, etc.)
- Features (shuttle, WiFi, loaner cars, warranties)
- History (established year, family-owned)
- Hours (operating schedule)
- Specializations (diesel, import, fleet, etc.)
Step 3: Extract Verified Claims
Review Firecrawl JSON output and extract:
{
"verified_claims": [
{
"claim": "ASE-Certified Technicians",
"source": "About page",
"exact_wording": "Our ASE-certified master technicians",
"confidence": "verified"
},
{
"claim": "Open Weekdays 8AM-6PM",
"source": "Contact page",
"exact_wording": "Monday-Friday: 8:00 AM - 6:00 PM",
"confidence": "verified"
}
],
"inferred_claims": [
{
"claim": "All Makes & Models",
"source": "Services page",
"inference": "States 'domestic, foreign, and diesel' - implies all makes",
"confidence": "inferred"
}
]
}Step 4: Create Ad Copy
Only use verified_claims for ad copy. Flag inferred_claims for user review.
Step 5: Document Sources
Present ad copy with source citations:
=== PROPOSED HEADLINES ===
1. "ASE-Certified Technicians"
✅ Source: About page - "Our ASE-certified master technicians"
2. "Serving [City] Since 1986"
✅ Source: Homepage - "Family owned and operated since 1986"
3. "Diesel Repair Specialists"
✅ Source: Services page - "Specializing in diesel truck repair"
=== EXCLUDED ===
4. "Open 7 Days a Week"
❌ NOT FOUND on website - Violates Rule 1 (verification required)
5. "Free Estimates"
❌ FOUND on website BUT excluded - Violates Rule 5 (no "Free" copy)
6. "Rated 5★ By Happy Customers"
❌ Generic placeholder - Violates Rule 1 (no verified source for rating/count)Quality Assurance Checklist
Before submitting ANY ad copy to user:
- Website scraping completed successfully
- Every claim has source citation (including flexible headlines and all copy)
- No assumptions or "industry standards" used
- No generic placeholders (e.g., "Happy Customers", "Rated 5★" without verified count)
- Template library used for formatting only (not content)
- All copy containing "Free" has been excluded (Rule 5)
- Inferred claims clearly flagged as such
- User notified of any limitations (website unavailable, etc.)
Error Handling
Website Unavailable
⚠️ WEBSITE SCRAPING LIMITATION
Website: [URL]
Status: Unable to access / Heavy JavaScript / No content
IMPACT:
- Cannot verify services, features, or credentials
- Recommendations limited to existing account data only
- No new claims or differentiators can be suggested
RECOMMENDATION:
Please manually review [URL] and provide:
- Services offered
- Credentials (ASE, BBB, etc.)
- Unique features (shuttle, warranty, etc.)
- Operating hours
- Any specializations
Then I can create verified ad copy based on your input.Partial Website Access
⚠️ LIMITED WEBSITE DATA
Successfully scraped: Homepage, Contact page
Unable to access: Services page, About page
VERIFIED CLAIMS:
- [List what was found]
CANNOT VERIFY:
- Detailed service list
- Credentials
- Company history
RECOMMENDATION:
Proceeding with verified claims only. Suggest manual review
of [URL]/services and [URL]/about for additional content.Examples by Ad Copy Type
Example 1: Responsive Search Ad Creation
User Request: "Create RSAs for [auto repair shop client]"
Correct Workflow:
- ✅ Scrape the business website
- ✅ Extract verified claims:
- "Established 1978" → Headline: "Serving You Since 1978"
- "AAA-Approved" → Headline: "AAA-Approved Repair Shop"
- "36 months/36,000 miles warranty" → Description: "36-month warranty on all repairs"
- ✅ Document sources for each headline/description
- ✅ Present to user with verification status
Incorrect Workflow:
- ❌ Look at RSA best practices templates
- ❌ Add generic headlines: "Expert Auto Repair", "Quality Service"
- ❌ Add assumed features: "Same Day Service", "Free Estimates"
- ❌ No website verification
Example 2: Callout Extension Audit
User Request: "Add callouts for [auto repair shop client]"
Correct Workflow:
- ✅ Scrape the business website
- ✅ Find: "BBB accredited", "Financing available", "Fleet services"
- ✅ Create callouts:
- "BBB Accredited Business" (Source: Homepage)
- "Financing Available" (Source: Services page)
- "Fleet Service Available" (Source: Services page — "fleet service department")
- ✅ Do NOT add: "Open Saturdays" (not on website)
Incorrect Workflow:
- ❌ Use callout template library
- ❌ Add "common" callouts without verification: "Same Day Service", "Open Saturdays"
- ❌ Add "Free Estimates" even if on website (violates Rule 5)
- ❌ No verification from actual website
Integration with Agents
Any agent that creates ad copy must:
- Import this skill at start:
Before creating any ad copy, review the ad-copy-verification-standard skill for mandatory requirements. - Follow verification workflow:
- Website scraping → Claim extraction → Source documentation → User review
- Never skip verification:
- Even for "simple" or "obvious" claims
- Even when user seems to be in a hurry
- Even when template seems perfect
Code Implementation Requirements
CRITICAL: When writing code that generates ad copy, these rules MUST be enforced in the code itself:
No Fallbacks Rule
# ❌ WRONG - Using fallbacks when data is missing
if not social_proof:
headlines.append("5-Star Reviews") # Generic placeholder
# ✅ CORRECT - Empty string when data is missing
if not social_proof:
headlines.append("") # Leave empty, do not fabricatePolicy: Empty > Inaccurate
Better to have an empty headline field than an unverified claim.
- If website data is missing → use empty string
- If review data is missing → use empty string
- If warranty not found → use empty string
- NEVER substitute generic placeholders
Code Must Reference This Skill
All RSA generation scripts should include a header reference:
"""
MUST FOLLOW: ad-copy-verification-standard
Key rules:
- NO generic placeholders
- NO fallbacks when data missing
- Empty string > unverified claim
"""Enforcement
This standard is MANDATORY for:
- ✅ Responsive Search Ad creation
- ✅ Callout extension recommendations
- ✅ Structured snippet recommendations
- ✅ Sitelink creation
- ✅ Any ad copy generation task
Agents that must comply:
- Any RSA creation agent
- Any ad copy generation agent
- Any portfolio audit agent that surfaces copy recommendations
Non-compliance consequences:
- User will request removal of unverified claims
- Creates cleanup work and wastes time
- Damages trust in AI-generated recommendations
Success Criteria
Ad copy creation is successful when:
- ✅ Every claim is verified from website scraping
- ✅ Every claim has documented source
- ✅ No assumptions or "industry standards" used
- ✅ User can trust all recommendations are factual
- ✅ Cleanup/removal work is not needed post-creation
When to Load Other Skills
| Skill | When |
ad-copy-generation-framework | Alongside this standard on any copy-generation task — it shapes verified claims into headlines and descriptions; this standard gates what goes in |
mutation-safety | When approved copy is written to a live account — its two-step approval is the last catch for unverified copy that slips through review |
investigation-methodology | When existing ad copy underperforms and you need a hypothesis-driven diagnosis before rewriting |
Built by Kurt Henninger. More free skills: github.com/fourteenwm/ppc-ai-skills
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

