local-seo
Build local SEO strategy. Use when: optimizing Google Business Profile, fixing NAP consistency, improving local pack rankings.
What this skill does
# Local SEO
## When to Use This Skill
## Context efficiency
Heavy skill. **Grep before Read** any referenced file, then `Read` only matched ranges with `offset` + `limit`. List `${CLAUDE_PLUGIN_DATA}/<brand>/` before opening files. On re-invocation mid-session, skip files already in context.
Activate this module when the user's request involves any of the following:
- **Google Business Profile Optimization**: Setting up, optimizing, or auditing a Google Business Profile (categories, attributes, photos, posts, Q&A, products, services)
- **Local Citations**: Building, auditing, or cleaning up business listings across directories and data aggregators
- **NAP Consistency**: Auditing Name, Address, Phone number consistency across the web
- **Local Pack / Map Pack Rankings**: Strategies to appear in the Google 3-pack and Google Maps results
- **Location Pages**: Creating or optimizing landing pages for individual business locations or service areas
- **Multi-Location SEO**: Managing local SEO at scale for businesses with multiple physical locations or franchise operations
- **"Near Me" Optimization**: Optimizing for proximity-based and implicit local searches
- **Local Link Building**: Earning links from local organizations, chambers of commerce, community partners, sponsorships, and local media
- **Local Schema Markup**: Implementing LocalBusiness, GeoCoordinates, OpeningHours, AggregateRating, and related structured data
- **Review Management for Local**: Generating reviews, improving ratings, responding to reviews, and leveraging reviews for local ranking signals
- **Service Area Businesses**: Optimizing for businesses without a physical storefront that serve customers at their locations
- **Local Content Strategy**: City pages, neighborhood guides, local event content, and geo-targeted blog posts
- **Google Maps Optimization**: Improving visibility and engagement within Google Maps specifically
- **Local Competitive Analysis**: Benchmarking local search performance against nearby competitors
**Trigger phrases**: "local seo," "google business profile," "gbp," "google maps," "local pack," "map pack," "near me," "local citations," "nap consistency," "location pages," "multi-location," "service area," "local link building," "local reviews," "local schema," "local business," "local rankings," "google 3-pack," "local directory," "local search," "store locator," "franchise seo," "city pages," "neighborhood seo"
## Brand Context (Auto-Applied)
Before producing any marketing output from this module:
1. **Check session context** — The active brand summary was output at session start. Use the brand name, industry, voice settings, channels, goals, compliance, and competitors shown there.
2. **If you need the full profile**, read: `~/.claude-marketing/brands/{slug}/profile.json`
3. **Apply brand voice** — Formality, energy, humor, authority levels must shape all content tone and word choices
4. **Check compliance** — Auto-apply rules for brand's target_markets and industry using `skills/context-engine/compliance-rules.md`
5. **Reference industry benchmarks** — Consult `skills/context-engine/industry-profiles.md` for the brand's industry
6. **Use platform specs** — Reference `skills/context-engine/platform-specs.md` for character limits and format requirements
7. **Check campaign history** — Run `python campaign-tracker.py --brand {slug} --action list-campaigns` before planning new work
8. **If no brand exists**, say: "No brand profile found. Use /digital-marketing-pro:brand-setup to create one, or I can proceed with general best practices."
9. **Check brand guidelines** — If `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json` exists, load and enforce: `restrictions.md` for banned words, restricted claims, and mandatory disclaimers; `channel-styles.md` for channel-specific tone overrides (may differ from base voice); `messaging.md` for approved key messages, taglines, and positioning language; `voice-and-tone.md` for detailed voice rules beyond the 4 numeric scores. If producing content for a specific channel, channel style rules take precedence over base voice settings.
Do not ask the user for information that already exists in their brand profile.
## Required Context
Before executing local SEO work, gather:
1. **Business Name & Address**: Exact legal business name and full street address (or multiple addresses for multi-location)
2. **Phone Number(s)**: Primary and tracking phone numbers in use
3. **Service Areas**: Geographic areas served (cities, counties, zip codes, radius)
4. **Number of Locations**: Single location, multi-location (how many), or service area business (no storefront)
5. **GBP Access**: Does the business have a claimed and verified Google Business Profile?
6. **Current Review Profile**: Average star rating, total review count, review velocity trend, and response rate
7. **Industry/Category**: Primary business category and any secondary categories currently set
8. **Local Competitors**: Top 3-5 businesses competing for the same local searches
9. **Current Rankings**: Known local pack positions for target keywords (if tracked)
10. **Website Structure**: Does the site have individual location pages? A store locator? Location-specific content?
11. **Existing Citations**: Known directory listings (Yelp, YP, BBB, industry-specific) and their accuracy
12. **Budget & Resources**: Team capacity for review management, content creation, and ongoing citation maintenance
For quick requests (e.g., "optimize my Google Business Profile"), proceed with available information. For comprehensive local SEO strategy, gather the full context.
## Capabilities
### Google Business Profile Optimization
- Profile completeness audit and optimization (every field, every section)
- Primary and secondary category selection strategy
- Business attribute configuration for ranking signals and user engagement
- Photo strategy (exterior, interior, team, product, at-work — quantity and quality benchmarks)
- Google Posts publishing strategy (What's New, Events, Offers — cadence and CTA optimization)
- Q&A section seeding and management
- Products and Services section optimization
- Business description keyword optimization within character limits
- Hours, special hours, and holiday hours management
- Booking and appointment URL integration
- Messaging and chat setup
- GBP suspension prevention and recovery procedures
- GBP Insights analysis and action planning
### Local Citation Building & NAP Management
- Structured citation audit across 50+ directories
- Unstructured citation identification (mentions in articles, press, blogs)
- NAP consistency scoring and discrepancy resolution
- Data aggregator submissions (Data Axle, Neustar Localeze, Foursquare)
- Industry-specific citation source identification and prioritization
- Duplicate listing detection and cleanup
- Citation velocity planning for steady listing growth
### Local Search Strategy
- Local keyword research (geo-modified terms, service+location combinations, implicit local queries)
- Local pack ranking factor analysis (proximity, prominence, relevance)
- Local competitive gap analysis (citations, reviews, content, links)
- Local SERP feature targeting (local pack, knowledge panel, local finder, Google Maps)
- "Near me" and voice search optimization for local intent
### Location Page & Local Content
- Location page template design with unique, substantive content per location
- Service area page strategy for SABs
- City and neighborhood landing pages (when appropriate, avoiding thin content)
- Local blog content planning (community events, local news, neighborhood guides)
- Localized testimonials and case studies
- Local FAQ content by industry
### Local Link Building
- Local partnership and sponsorship link opportunities
- Chamber of commerce and business association memberships
- Local media and press link earning
- Community event sponsorship and participation
- Local scholarship and charitRelated in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".