heymegabyte/agent-skills / 15-site-generation
site-generation
UnverifiedEnd-to-end AI website generation pipeline. Claude Opus 4.8 emits Bolt-style <boltArtifact> envelopes (multi-file, plan-first) that customize Vite+React+Tailwind templates from pre-researched business data. Pre-research via APIs, media acquisition, brand extraction, visual inspection via GPT Image 2 vision, R2 upload (per-file content-type by extension), D1 status updates. Supports all business types: SaaS, portfolio, non-profit, restaurant, salon, medical, legal, retail, tech.
local-seo.md
View on GitHub---
name: "local-seo"
description: "Local SEO pipeline: citation building, GBP sync, review generation, trust badge verification, local conversion tracking. The delta between 'good local website' and '#1 in the Map Pack.'"
updated: "2026-04-25"
---
# Local SEO Pipeline (***MAP PACK DOMINATION***)
## Google Business Profile Sync (***CRITICAL***)
Website and GBP must match EXACTLY — divergence hurts rankings. After site generation:
### Auto-sync fields
- Business name, address, phone (NAP consistency across ALL citations)
- Hours (including holiday exceptions)
- Services list, business description (first 750 chars most important)
- Categories (primary + secondary), attributes (wheelchair accessible, free wifi, etc.)
- Photos (upload hero + top 5 from `assets/`)
### GBP Posts
Generate 3 initial posts from site content: welcome/intro, featured service/product, special offer or event. Schedule via GBP API or manual instructions in `_gbp_sync.json`.
### Output file
`_gbp_sync.json` — structured data matching GBP fields exactly. Worker auto-pushes via Google My Business API (OAuth required) or generates human-readable instructions for manual update.
### NAP consistency check
After build, verify Name+Address+Phone match across: site header, site footer, JSON-LD, Google Maps embed, contact page, GBP listing. Any mismatch = build failure.
## Citation Building (***LOCAL RANK SIGNAL #2***)
### Tier 1 — Essential (submit within 24hr of site launch)
- Google Business Profile, Apple Maps Connect, Bing Places, Yelp Business, Facebook Business Page, Better Business Bureau
### Tier 2 — Industry Directories (submit within 1 week)
- **Medical** — Healthgrades, Vitals, ZocDoc, WebMD, RateMDs
- **Legal** — Avvo, FindLaw, Justia, Martindale-Hubbell, Lawyers.com
- **Restaurant** — TripAdvisor, OpenTable, Grubhub, DoorDash, Zomato
- **Salon/Spa** — StyleSeat, Booksy, Vagaro, SalonCentric
- **Real Estate** — Zillow, Realtor.com, Trulia, Redfin
- **Automotive** — CarFax, RepairPal, AutoMD, Mechanic Advisor
- **Construction** — Houzz, Angi, HomeAdvisor, Thumbtack, Porch
- **Financial** — NerdWallet, WalletHub, CPA Directory
- **Fitness** — ClassPass, Mindbody, Gympass
- **Education** — Niche, GreatSchools, US News
- **Photography** — The Knot, WeddingWire, Thumbtack
- **Pet Services** — Rover, Care.com, BringFido
### Tier 3 — General Directories (submit within 2 weeks)
- Yellow Pages, Manta, Foursquare, Hotfrog, Superpages
- CitySearch, Local.com, MerchantCircle, Brownbook, eLocal
### Output file
`_citations.json` — list of directories with: name, URL, submission status (pending/submitted/verified), NAP data, category. Worker tracks status in D1.
### Automation
- Directories with APIs (Yelp, Foursquare, Apple Maps): auto-submit via Worker
- Manual-only directories: generate step-by-step instructions with pre-filled data in `_citation_instructions.md`
## Review Generation (***LOCAL RANK SIGNAL #1***)
Review velocity (new reviews/month) is the single biggest Map Pack signal.
### QR-to-Review Flow
Generate `assets/review-qr.svg` — QR linking to `https://search.google.com/local/writereview?placeid={PLACE_ID}`. Display on: thank-you page, email footer, printable card PDF in `assets/`.
### Review Request Page
Build `/review` page: "How was your experience?" → 5-star rating. ≥4 stars: redirect to Google review page. <3 stars: show private feedback form (prevents negative public review).
### Post-Visit Automation (instructions for business owner)
Generate `_review_automation.md` with setup instructions for:
- **Email** — Resend template triggered 24hr after appointment/purchase. Subject: "How was your visit to `{business_name}`?" CTA links to Google review URL.
- **SMS** — Twilio template (if phone collected). Same timing, shorter copy.
- **In-store** — Printable QR card PDF for counter/receipt.
### Review Widget on Site
- Pull Google Places reviews → display with star rating, reviewer name, date, text (truncated with "Read more" linking to Google)
- Carousel on mobile; min 3 reviews displayed
- If <3 reviews: show testimonial section + CTA to leave first review
## Trust Badge Verification (***CONVERSION SIGNAL***)
### Auto-Discovery Pipeline
From research data, identify claimed certifications and verify:
- **BBB Rating** — BBB API or scrape → BBB badge with rating letter
- **Chamber of Commerce** — local chamber scrape → Member badge with year
- **Google Guaranteed** — Google LSA API → Green checkmark badge
- **ASE Certified** (auto) — ASE website → Blue seal with specialties
- **HIPAA Compliant** (medical) — self-declared → badge in footer
- **ADA Compliant** — self-declared after axe-core pass → badge in footer
- **Licensed & Insured** — state license board scrape → license # in footer
- **SOC2/GDPR** (SaaS) — self-declared → badge in footer + trust section
- **Angi/HomeAdvisor** (construction) — Angi API or scrape → rating badge
- **ABMP** (massage) — ABMP directory → Member badge
### Badge image generation
If no official badge available, generate clean SVG badge with Ideogram: `{Certification Name}` + icon + year. Store in `assets/badges/`.
### Display pattern
- Trust badges section after hero or in sidebar; footer row of badge images
- Service pages show relevant certifications inline
## Local Conversion Tracking (***MEASURE WHAT MATTERS***)
### Event Taxonomy (PostHog + GA4)
- `phone_click` — `tel:` link clicked (**primary conversion**)
- `direction_click` — Google Maps directions clicked
- `form_submit` — contact/booking form submitted
- `booking_click` — external booking CTA clicked
- `email_click` — `mailto:` link clicked
- `chat_open` — live chat widget opened
- `review_click` — review CTA clicked
- `menu_download` — PDF menu downloaded (restaurant)
- `coupon_claim` — special offer/coupon clicked
- `social_click` — social media profile link clicked
### GA4 Goals (auto-configure via GTM)
1. **Phone Call** — `phone_click`
2. **Direction Request** — `direction_click`
3. **Form Submission** — `form_submit`
4. **Booking** — `booking_click`
### Call Tracking (optional, premium)
- **Google forwarding number** via Google Ads (free with ads account)
- **CallRail** integration ($45/mo)
Tracks: call duration, caller location, call recording, missed call alerts. Without call tracking, count `tel:` clicks as proxy.
### Local Funnel
Visit → Page View → Engagement (scroll 50%+) → Micro-conversion (menu view, gallery browse) → Macro-conversion (call, directions, form, booking)
PostHog funnel: define per-site, track weekly conversion rate. Alert if rate drops >20% week-over-week.
## Local Schema Enhancements
Beyond basic JSON-LD, add:
- **`geo` coordinates** — lat/lng from Google Places (Map Pack signal)
- **`areaServed`** — list of cities/neighborhoods served
- **`priceRange`** — "$" to "$$$$" from research
- **`aggregateRating`** — from Google Places reviews
- **`hasMenu`** — for restaurants (MenuSection+MenuItem)
- **`openingHoursSpecification`** — day-by-day including exceptions
- **`paymentAccepted`** — Cash, Credit Card, etc.
- **`currenciesAccepted`** — USD
- **`sameAs`** — all verified social profiles
- **`knowsAbout`** — services/specialties list
## Integration Points
- `research-pipeline.md` → provides Place ID, reviews, hours, geo for GBP sync
- `media-acquisition.md` → badge images generated alongside other assets
- `build-prompts.md` → review widget + trust badges injected into build
- `quality-gates.md` → NAP consistency check added to quality scoring
- `domain-features.md` → conversion events match feature CTAs
- `13-observability-and-growth` → local conversion events fire alongside SaaS events
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |