opencode-skills-antigravity 1.0.4 → 1.0.6

package/bundled-skills/seo-plan/assets/local-service.md

@@ -0,0 +1,160 @@
+<!-- Updated: 2026-02-07 -->
+# Local Service Business SEO Strategy Template
+
+## Industry Characteristics
+
+- Geographic-focused searches
+- High intent, quick decision making
+- Reviews heavily influence decisions
+- Phone calls are primary conversion
+- Mobile-first user behavior
+- Emergency/urgent service needs
+
+## Recommended Site Architecture
+
+```
+/
+├── Home
+├── /services
+│   ├── /service-1
+│   ├── /service-2
+│   └── ...
+├── /locations
+│   ├── /city-1
+│   │   ├── /service-1-city-1
+│   │   └── ...
+│   ├── /city-2
+│   └── ...
+├── /about
+├── /reviews
+├── /gallery (or /portfolio)
+├── /blog
+├── /contact
+├── /emergency (if applicable)
+└── /faq
+```
+
+## Quality Gates
+
+### Location Page Limits
+- ⚠️ **WARNING** at 30+ location pages
+- 🛑 **HARD STOP** at 50+ location pages
+
+### Unique Content Requirements
+| Page Type | Min Words | Unique % |
+|-----------|-----------|----------|
+| Primary Location | 600 | 60%+ |
+| Service Area | 500 | 40%+ |
+| Service Page | 800 | 100% |
+
+### What Makes Location Pages Unique
+- Local landmarks and neighborhoods
+- Specific services offered at that location
+- Local team members
+- Location-specific testimonials
+- Community involvement
+- Local regulations or considerations
+
+## Schema Recommendations
+
+| Page Type | Schema Types |
+|-----------|-------------|
+| Homepage | LocalBusiness, Organization |
+| Service Pages | Service, LocalBusiness |
+| Location Pages | LocalBusiness (with geo) |
+| Contact | ContactPage, LocalBusiness |
+| Reviews | LocalBusiness (with AggregateRating) |
+
+### LocalBusiness Schema Example
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "LocalBusiness",
+  "name": "Business Name",
+  "address": {
+    "@type": "PostalAddress",
+    "streetAddress": "123 Main St",
+    "addressLocality": "City",
+    "addressRegion": "State",
+    "postalCode": "12345"
+  },
+  "telephone": "+1-555-555-5555",
+  "openingHours": "Mo-Fr 08:00-18:00",
+  "geo": {
+    "@type": "GeoCoordinates",
+    "latitude": "40.7128",
+    "longitude": "-74.0060"
+  },
+  "areaServed": ["City 1", "City 2"],
+  "priceRange": "$$"
+}
+```
+
+## Google Business Profile Integration
+
+- Ensure NAP consistency (Name, Address, Phone)
+- Sync service categories
+- Regular post updates
+- Photo uploads
+- Review response strategy
+
+### Google Business Profile Updates (2025-2026)
+
+- **Video verification** is now standard: postcard verification has been largely phased out. Prepare for a short video verification process showing the business location or service area.
+- **WhatsApp integration** replaced Google Business Chat (deprecated). Businesses can connect WhatsApp as their primary messaging channel.
+- **Q&A removed from Maps**: replaced by AI-generated answers. Ensure your GBP description, services, and website FAQ are comprehensive, as Google AI uses them to answer queries.
+- **Business hours are a top-5 ranking factor**: "Business is open at time of search" ranked as a top individual factor for the first time (Whitespark 2026 Local Search Ranking Factors Report). Keep hours accurate; consider extended hours if feasible.
+- **Review "Stories" format**: Google Maps now shows review snippets in a swipeable Stories format on mobile. Encourage detailed, descriptive reviews with photos.
+
+### Service Area Business (SAB) Update (June 2025)
+
+Google updated SAB guidelines to **disallow entire states or countries** as service areas. SABs must specify: cities, postal/ZIP codes, or neighborhoods. If you serve an entire metro area, list the major cities within it rather than the state.
+
+### AI Visibility for Local Businesses
+
+AI Overviews appear for only ~0.14% of local keywords (March 2025 data), local SEO faces significantly less AI disruption than other verticals. However, ChatGPT and Perplexity are increasingly used for local recommendations.
+
+To optimize for AI local visibility:
+- Ensure presence on expert-curated "best of" lists (ranked #1 AI visibility factor in Whitespark 2026 report)
+- Maintain consistent NAP (Name, Address, Phone) across all platforms
+- Build genuine review volume and quality
+- Use LocalBusiness schema with complete properties (geo, openingHours, priceRange, areaServed)
+
+## Content Priorities
+
+### High Priority
+1. Homepage with clear service area
+2. Core service pages
+3. Primary city page
+4. Contact page with all locations
+
+### Medium Priority
+1. Service + location combination pages
+2. FAQ page
+3. About/team page
+4. Reviews/testimonials page
+
+### Blog Topics
+- Seasonal maintenance tips
+- How to choose a [service provider]
+- Warning signs of [problem]
+- DIY vs professional comparisons
+- Local regulations and permits
+
+## Key Metrics to Track
+
+- Local pack rankings
+- Phone call volume from organic
+- Direction requests
+- Google Business Profile insights
+- Reviews count and rating
+
+## Generative Engine Optimization (GEO) for Local
+
+- [ ] Include clear, quotable service descriptions and pricing ranges
+- [ ] Use LocalBusiness schema with complete geo, openingHours, and areaServed
+- [ ] Build presence on curated "best of" and local directory lists
+- [ ] Maintain consistent NAP across all platforms (Google, Yelp, Apple Maps)
+- [ ] Include original photos of work, team, and location
+- [ ] Structure FAQ content for common local service questions
+- [ ] Monitor AI citation in ChatGPT and Perplexity local recommendations

package/bundled-skills/seo-plan/assets/publisher.md

@@ -0,0 +1,153 @@
+<!-- Updated: 2026-02-07 -->
+# Publisher/Media SEO Strategy Template
+
+## Industry Characteristics
+
+- High content volume
+- Time-sensitive content (news)
+- Ad revenue dependent on traffic
+- Authority and trust critical
+- Competing with social platforms
+- AI Overviews impact on traffic
+
+## Recommended Site Architecture
+
+```
+/
+├── Home
+├── /news (or /latest)
+├── /topics
+│   ├── /topic-1
+│   ├── /topic-2
+│   └── ...
+├── /authors
+│   ├── /author-1
+│   └── ...
+├── /opinion
+├── /reviews
+├── /guides
+├── /videos
+├── /podcasts
+├── /newsletter
+├── /about
+│   ├── /editorial-policy
+│   ├── /corrections
+│   └── /contact
+└── /[year]/[month]/[slug] (article URLs)
+```
+
+## Schema Recommendations
+
+| Page Type | Schema Types |
+|-----------|-------------|
+| Article | NewsArticle or Article, Person (author), Organization (publisher) |
+| Author Page | Person, ProfilePage |
+| Topic Page | CollectionPage, ItemList |
+| Homepage | WebSite, Organization |
+| Video | VideoObject |
+| Podcast | PodcastEpisode, PodcastSeries |
+
+### NewsArticle Schema Example
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "NewsArticle",
+  "headline": "Article Headline",
+  "datePublished": "2026-02-07T10:00:00Z",
+  "dateModified": "2026-02-07T14:30:00Z",
+  "author": {
+    "@type": "Person",
+    "name": "Author Name",
+    "url": "https://example.com/authors/author-name"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "Publication Name",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "https://example.com/logo.png"
+    }
+  },
+  "image": ["https://example.com/article-image.jpg"],
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "https://example.com/article-url"
+  }
+}
+```
+
+## E-E-A-T Requirements
+
+Publishers face highest E-E-A-T scrutiny.
+
+### Author Pages Must Include
+- Full name and photo
+- Bio and credentials
+- Areas of expertise
+- Contact information
+- Social profiles (sameAs)
+- Previous articles by this author
+
+### Editorial Standards
+- Clear correction policy
+- Transparent editorial process
+- Fact-checking procedures
+- Conflict of interest disclosures
+
+## Content Priorities
+
+### High Priority
+1. Breaking news (speed matters)
+2. Evergreen guides on core topics
+3. Author pages with credentials
+4. Topic hubs/pillar pages
+
+### Medium Priority
+1. Opinion/analysis pieces
+2. Video content
+3. Interactive content
+4. Newsletter landing pages
+
+### GEO Considerations
+- Clear, quotable facts in articles
+- Tables for data-heavy content
+- Expert quotes with attribution
+- Update dates prominently displayed
+- Structured headings (H2/H3)
+- First-party data and original research are highly cited by AI systems
+- Ensure author entities are clearly defined with Person schema + sameAs links
+- Monitor AI citation frequency across Google AI Overviews, AI Mode, ChatGPT, Perplexity
+- Treat AI citation as a standalone KPI alongside organic traffic
+
+### Publisher SEO Updates (2025-2026)
+
+- **Google News automatic inclusion:** Google News no longer accepts manual applications (since March 2025). Inclusion is fully automatic based on Google's content quality criteria. Focus on Google News sitemap markup and consistent, high-quality publishing cadence.
+- **KPI shift:** Traffic-based KPIs (sessions, pageviews) are declining in relevance as AI Overviews reduce click-through rates. Leading publishers are shifting to: subscriber conversions, time on page, scroll depth, newsletter signups, AI citation frequency, and revenue per visitor.
+- **Site reputation abuse risk:** Publishers hosting third-party content (coupons, product reviews, affiliate content) under their domain are at high risk. Google penalized Forbes, WSJ, Time, and CNN for this in late 2024. If hosting third-party content, ensure strong editorial oversight and clear first-party involvement.
+
+## Technical Considerations
+
+### Core Web Vitals
+- Ad placement affects CLS
+- Lazy load ads and images below fold
+- Optimize hero images for LCP
+- Minimize render-blocking resources
+
+### AMP (if used)
+- Consider dropping AMP (no longer required for Top Stories)
+- Ensure canonical setup is correct
+- Monitor performance vs non-AMP
+
+### Pagination
+- Proper pagination for multi-page articles
+- Or infinite scroll with proper indexing
+- Canonical to page 1 or full article
+
+## Key Metrics to Track
+
+- Page views from organic
+- Time on page
+- Pages per session
+- Newsletter signups from organic
+- Google News/Discover traffic
+- AI Overview appearances

package/bundled-skills/seo-plan/assets/saas.md

@@ -0,0 +1,135 @@
+<!-- Updated: 2026-02-07 -->
+# SaaS SEO Strategy Template
+
+## Industry Characteristics
+
+- Long sales cycles with multiple touchpoints
+- Feature-focused decision making
+- Comparison shopping behavior
+- Heavy research phase before purchase
+- Integration and ecosystem considerations
+
+## Recommended Site Architecture
+
+```
+/
+├── Home
+├── /product (or /platform)
+│   ├── /features
+│   │   ├── /feature-1
+│   │   ├── /feature-2
+│   │   └── ...
+│   ├── /integrations
+│   │   ├── /integration-1
+│   │   └── ...
+│   └── /security
+├── /solutions
+│   ├── /by-industry
+│   │   ├── /industry-1
+│   │   └── ...
+│   └── /by-use-case
+│       ├── /use-case-1
+│       └── ...
+├── /pricing
+├── /customers
+│   ├── /case-studies
+│   │   ├── /case-study-1
+│   │   └── ...
+│   └── /testimonials
+├── /resources
+│   ├── /blog
+│   ├── /guides
+│   ├── /webinars
+│   ├── /templates
+│   └── /glossary
+├── /docs (or /help)
+│   └── /api
+├── /company
+│   ├── /about
+│   ├── /careers
+│   ├── /press
+│   └── /contact
+└── /compare
+    ├── /vs-competitor-1
+    └── /vs-competitor-2
+```
+
+## Content Priorities
+
+### High Priority Pages
+1. Homepage (value proposition, social proof)
+2. Features overview
+3. Pricing page
+4. Key integrations
+5. Top 3-5 use case pages
+
+### Medium Priority Pages
+1. Individual feature pages
+2. Industry solution pages
+3. Case studies (2-3 detailed ones)
+4. Comparison pages (vs competitors)
+
+### Content Marketing Focus
+1. Bottom-of-funnel: Comparison guides, ROI calculators
+2. Middle-of-funnel: How-to guides, best practices
+3. Top-of-funnel: Industry trends, educational content
+
+## Schema Recommendations
+
+| Page Type | Schema Types |
+|-----------|-------------|
+| Homepage | Organization, WebSite, SoftwareApplication |
+| Product/Features | SoftwareApplication, Offer |
+| Pricing | SoftwareApplication, Offer (with pricing) |
+| Blog | Article, BlogPosting |
+| Case Studies | Article, Organization (customer) |
+| Documentation | TechArticle |
+
+## Key Metrics to Track
+
+- Organic traffic to pricing page
+- Demo/trial signups from organic
+- Blog → pricing page conversion
+- Comparison page rankings
+- Integration page performance
+
+## Comparison & Alternative Pages
+
+Comparison pages are among the highest-converting content types for SaaS, with conversion rates of **4-7%** vs. 0.5-1.8% for standard blog content (35.8% of marketers report comparison content performs "better than ever" per Intergrowth November 2025 survey).
+
+**Recommended page types:**
+- `/{product}-vs-{competitor}`: Direct 1:1 comparison
+- `/{competitor}-alternative`: Targeting competitor brand searches
+- `/compare/{category}`: Category comparison hub
+- `/best-{category}-tools`: Roundup-style pages
+
+**Best practices:**
+- Include structured comparison tables with pricing, features, pros/cons
+- Be factually accurate about competitors: verify claims regularly
+- Include customer testimonials from users who switched
+- Add FAQ schema for common comparison questions (valuable for AI search)
+- Update regularly: stale comparison data damages credibility
+- Cross-reference the `seo-competitor-pages` skill for detailed frameworks
+
+**Legal considerations:**
+- Nominative fair use generally permits competitor brand mentions for comparison purposes
+- Do NOT imply endorsement or affiliation
+- Do NOT make false or unverifiable claims about competitor products
+- Different jurisdictions have different trademark laws: consult legal counsel
+
+## Competitive Considerations
+
+- Monitor competitor feature releases
+- Track competitor content strategies
+- Identify keyword gaps in feature coverage
+- Watch for new comparison opportunities
+
+## Generative Engine Optimization (GEO) for SaaS
+
+- [ ] Include clear, structured feature comparisons that AI systems can parse and cite
+- [ ] Use SoftwareApplication schema with complete feature lists and pricing
+- [ ] Publish original benchmark data, case studies, and ROI metrics
+- [ ] Build content clusters around key product categories and use cases
+- [ ] Ensure integration pages have clear, quotable descriptions
+- [ ] Structure pricing information in tables AI can extract
+- [ ] Monitor AI citation across Google AI Overviews, ChatGPT, and Perplexity

package/bundled-skills/seo-programmatic/SKILL.md

@@ -0,0 +1,184 @@
+---
+name: seo-programmatic
+description: "Plan and audit programmatic SEO pages generated at scale from structured data. Use when designing templates, URL systems, internal linking, quality gates, and index-bloat safeguards for pages at scale."
+risk: unknown
+source: "https://github.com/AgriciDaniel/claude-seo"
+date_added: "2026-03-21"
+user-invokable: true
+argument-hint: "[url or plan]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - WebFetch
+  - Write
+---
+
+# Programmatic SEO Analysis & Planning
+
+Build and audit SEO pages generated at scale from structured data sources.
+Enforces quality gates to prevent thin content penalties and index bloat.
+
+## When to Use
+
+- Use when the user wants programmatic SEO planning or review.
+- Use when designing templates, data-driven pages, or scalable URL systems.
+- Use when preventing thin content and index bloat across large page sets.
+
+## Data Source Assessment
+
+Evaluate the data powering programmatic pages:
+- **CSV/JSON files**: Row count, column uniqueness, missing values
+- **API endpoints**: Response structure, data freshness, rate limits
+- **Database queries**: Record count, field completeness, update frequency
+- Data quality checks:
+  - Each record must have enough unique attributes to generate distinct content
+  - Flag duplicate or near-duplicate records (>80% field overlap)
+  - Verify data freshness; stale data produces stale pages
+
+## Template Engine Planning
+
+Design templates that produce unique, valuable pages:
+- **Variable injection points**: Title, H1, body sections, meta description, schema
+- **Content blocks**: Static (shared across pages) vs dynamic (unique per page)
+- **Conditional logic**: Show/hide sections based on data availability
+- **Supplementary content**: Related items, contextual tips, user-generated content
+- Template review checklist:
+  - Each page must read as a standalone, valuable resource
+  - No "mad-libs" patterns (just swapping city/product names in identical text)
+  - Dynamic sections must add genuine information, not just keyword variations
+
+## URL Pattern Strategy
+
+### Common Patterns
+- `/tools/[tool-name]`: Tool/product directory pages
+- `/[city]/[service]`: Location + service pages
+- `/integrations/[platform]`: Integration landing pages
+- `/glossary/[term]`: Definition/reference pages
+- `/templates/[template-name]`: Downloadable template pages
+
+### URL Rules
+- Lowercase, hyphenated slugs derived from data
+- Logical hierarchy reflecting site architecture
+- No duplicate slugs; enforce uniqueness at generation time
+- Keep URLs under 100 characters
+- No query parameters for primary content URLs
+- Consistent trailing slash usage (match existing site pattern)
+
+## Internal Linking Automation
+
+- **Hub/spoke model**: Category hub pages linking to individual programmatic pages
+- **Related items**: Auto-link to 3-5 related pages based on data attributes
+- **Breadcrumbs**: Generate BreadcrumbList schema from URL hierarchy
+- **Cross-linking**: Link between programmatic pages sharing attributes (same category, same city, same feature)
+- **Anchor text**: Use descriptive, varied anchor text. Avoid exact-match keyword repetition
+- Link density: 3-5 internal links per 1000 words (match seo-content guidelines)
+
+## Thin Content Safeguards
+
+### Quality Gates
+
+| Metric | Threshold | Action |
+|--------|-----------|--------|
+| Pages without content review | 100+ | ⚠️ WARNING: require content audit before publishing |
+| Pages without justification | 500+ | 🛑 HARD STOP: require explicit user approval and thin content audit |
+| Unique content per page | <40% | ❌ Flag as thin content (likely penalty risk) |
+| Word count per page | <300 | ⚠️ Flag for review (may lack sufficient value) |
+
+### Scaled Content Abuse: Enforcement Context (2025-2026)
+
+Google's Scaled Content Abuse policy (introduced March 2024) saw major enforcement escalation in 2025:
+
+- **June 2025:** Wave of manual actions targeting websites with AI-generated content at scale
+- **August 2025:** SpamBrain spam update enhanced pattern detection for AI-generated link schemes and content farms
+- **Result:** Google reported 45% reduction in low-quality, unoriginal content in search results post-March 2024 enforcement
+
+**Enhanced quality gates for programmatic pages:**
+- **Content differentiation:** ≥30-40% of content must be genuinely unique between any two programmatic pages (not just city/keyword string replacement)
+- **Human review:** Minimum 5-10% sample review of generated pages before publishing
+- **Progressive rollout:** Publish in batches of 50-100 pages. Monitor indexing and rankings for 2-4 weeks before expanding. Never publish 500+ programmatic pages simultaneously without explicit quality review.
+- **Standalone value test:** Each page should pass: "Would this page be worth publishing even if no other similar pages existed?"
+- **Site reputation abuse:** If publishing programmatic content under a high-authority domain (not your own), this may trigger site reputation abuse penalties. Google began enforcing this aggressively in November 2024.
+
+> **Recommendation:** The WARNING gate at `<40% unique content` remains appropriate. Consider a HARD STOP at `<30%` unique content to prevent scaled content abuse risk.
+
+### Safe Programmatic Pages (OK at scale)
+✅ Integration pages (with real setup docs, API details, screenshots)
+✅ Template/tool pages (with downloadable content, usage instructions)
+✅ Glossary pages (200+ word definitions with examples, related terms)
+✅ Product pages (unique specs, reviews, comparison data)
+✅ Data-driven pages (unique statistics, charts, analysis per record)
+
+### Penalty Risk (avoid at scale)
+❌ Location pages with only city name swapped in identical text
+❌ "Best [tool] for [industry]" without industry-specific value
+❌ "[Competitor] alternative" without real comparison data
+❌ AI-generated pages without human review and unique value-add
+❌ Pages where >60% of content is shared template boilerplate
+
+### Uniqueness Calculation
+Unique content % = (words unique to this page) / (total words on page) × 100
+
+Measure against all other pages in the programmatic set. Shared headers, footers, and navigation are excluded from the calculation. Template boilerplate text IS included.
+
+## Canonical Strategy
+
+- Every programmatic page must have a self-referencing canonical tag
+- Parameter variations (sort, filter, pagination) canonical to the base URL
+- Paginated series: canonical to page 1 or use rel=next/prev
+- If programmatic pages overlap with manual pages, the manual page is canonical
+- No canonical to a different domain unless intentional cross-domain setup
+
+## Sitemap Integration
+
+- Auto-generate sitemap entries for all programmatic pages
+- Split at 50,000 URLs per sitemap file (protocol limit)
+- Use sitemap index if multiple sitemap files needed
+- `<lastmod>` reflects actual data update timestamp (not generation time)
+- Exclude noindexed programmatic pages from sitemap
+- Register sitemap in robots.txt
+- Update sitemap dynamically as new records are added to data source
+
+## Index Bloat Prevention
+
+- **Noindex low-value pages**: Pages that don't meet quality gates
+- **Pagination**: Noindex paginated results beyond page 1 (or use rel=next/prev)
+- **Faceted navigation**: Noindex filtered views, canonical to base category
+- **Crawl budget**: For sites with >10k programmatic pages, monitor crawl stats in Search Console
+- **Thin page consolidation**: Merge records with insufficient data into aggregated pages
+- **Regular audits**: Monthly review of indexed page count vs intended count
+
+## Output
+
+### Programmatic SEO Score: XX/100
+
+### Assessment Summary
+| Category | Status | Score |
+|----------|--------|-------|
+| Data Quality | ✅/⚠️/❌ | XX/100 |
+| Template Uniqueness | ✅/⚠️/❌ | XX/100 |
+| URL Structure | ✅/⚠️/❌ | XX/100 |
+| Internal Linking | ✅/⚠️/❌ | XX/100 |
+| Thin Content Risk | ✅/⚠️/❌ | XX/100 |
+| Index Management | ✅/⚠️/❌ | XX/100 |
+
+### Critical Issues (fix immediately)
+### High Priority (fix within 1 week)
+### Medium Priority (fix within 1 month)
+### Low Priority (backlog)
+
+### Recommendations
+- Data source improvements
+- Template modifications
+- URL pattern adjustments
+- Quality gate compliance actions
+
+## Error Handling
+
+| Scenario | Action |
+|----------|--------|
+| URL unreachable | Report connection error with status code. Suggest verifying URL accessibility and checking for authentication requirements. |
+| No programmatic pages detected | Inform user that no template-generated or data-driven page patterns were found. Suggest checking if pages use client-side rendering or if the URL points to the correct section. |
+| Thin content threshold exceeded | Trigger quality gate warning. Report the unique content percentage and flag pages below 40% uniqueness. Require user acknowledgment before proceeding. |
+| Quality gate violation | Halt analysis at the HARD STOP threshold (500+ pages without justification or <30% unique content). Present findings and require explicit user approval to continue. |