@hybridlabor-api/bdb-antigravity-skills 1.0.0

package/skills/global_config/seo/references/quality-gates.md

@@ -0,0 +1,155 @@
+# Content Quality Gates
+
+## Minimum Word Counts by Page Type
+
+| Page Type | Min Words | Unique Content % | Notes |
+|-----------|-----------|-----------------|-------|
+| Homepage | 500 | 100% | Must clearly communicate value proposition |
+| Service / Feature Page | 800 | 100% | Detailed explanation of offering |
+| Location (Primary) | 600 | 60%+ | City headquarters or main service area |
+| Location (Secondary) | 500 | 40%+ | Satellite locations |
+| Blog Post | 1,500 | 100% | In-depth, valuable content |
+| Product Page | 400 | 80%+ | Unique descriptions, specs |
+| Category Page | 400 | 100% | Unique intro, not just product listings |
+| About Page | 400 | 100% | Company story, team, values |
+| Landing Page | 600 | 100% | Focused conversion content |
+| FAQ Page | 800 | 100% | Comprehensive Q&A |
+
+---
+
+## Location Page Thresholds
+
+### Warning Level (30+ pages)
+- ⚠️ **WARNING** at 30+ location pages
+- Enforce 60%+ unique content per page
+- Content must include:
+  - Unique local information (landmarks, neighborhoods)
+  - Location-specific services or offerings
+  - Local team or staff information
+  - Genuine customer testimonials from that area
+
+### Hard Stop (50+ pages)
+- 🛑 **HARD STOP** at 50+ location pages
+- Require explicit user justification
+- Must demonstrate:
+  - Legitimate business presence in each location
+  - Unique content strategy for each page
+  - Local signals (Google Business Profile, local reviews)
+
+### Why This Matters
+Google's doorway page algorithm penalizes programmatic location pages with thin/duplicate content. Signs of doorway pages:
+- Only city/state name changed between pages
+- No unique local information
+- No local business signals
+- Keyword-stuffed URLs
+
+---
+
+## Safe vs. Risky Programmatic Pages
+
+### Safe at Scale ✅
+| Page Type | Why It's Safe |
+|-----------|---------------|
+| Integration pages | Real setup documentation, unique technical content |
+| Template/tool pages | Downloadable assets, unique functionality |
+| Glossary pages | 200+ word unique definitions |
+| Product pages | Unique specs, images, reviews |
+| User profile pages | User-generated unique content |
+
+### Penalty Risk ❌
+| Page Type | Why It's Risky |
+|-----------|----------------|
+| Location pages with only city swapped | Duplicate content, doorway pages |
+| "Best [tool] for [industry]" | Often thin, no industry-specific value |
+| "[Competitor] alternative" | Requires genuine comparison data |
+| AI-generated mass content | No unique value, E-E-A-T failure |
+
+---
+
+## Title Tag Requirements
+
+| Aspect | Requirement |
+|--------|-------------|
+| Minimum length | 30 characters |
+| Maximum length | 60 characters (Google truncates ~60) |
+| Primary keyword | Near the beginning |
+| Brand name | At end (if included) |
+| Uniqueness | Each page must have unique title |
+
+### Good Examples
+- "Emergency Plumbing Services in Austin | ABC Plumbing"
+- "How to Fix a Leaky Faucet: Step-by-Step Guide"
+- "Enterprise SEO Software | Comprehensive Platform"
+
+### Bad Examples
+- "Home" (too short, not descriptive)
+- "Best Plumbing Services for All Your Plumbing Needs in Austin Texas and Surrounding Areas" (too long)
+- "ABC Plumbing - Plumbing - Plumber - Plumbing Services" (keyword stuffing)
+
+---
+
+## Meta Description Requirements
+
+| Aspect | Requirement |
+|--------|-------------|
+| Minimum length | 120 characters |
+| Maximum length | 160 characters (Google truncates ~155-160) |
+| Call-to-action | Include compelling CTA |
+| Primary keyword | Include naturally |
+| Uniqueness | Each page must have unique description |
+
+---
+
+## Image Alt Text Requirements
+
+| Aspect | Requirement |
+|--------|-------------|
+| Required on | All non-decorative images |
+| Length | 10-125 characters |
+| Content | Describe the image content, not "image" or filename |
+| Keywords | Include naturally where relevant |
+| Decorative images | Use `alt=""` or `role="presentation"` |
+
+### Good Examples
+- "Professional plumber repairing kitchen sink faucet"
+- "Red 2024 Toyota Camry sedan front view"
+- "Team meeting in modern office conference room"
+
+### Bad Examples
+- "image.jpg" (filename, not description)
+- "plumber plumbing plumber services" (keyword stuffing)
+- "Click here" (not descriptive)
+
+---
+
+## Internal Linking Guidelines
+
+| Page Type | Internal Links Target |
+|-----------|----------------------|
+| Blog post (1,500+ words) | 5-10 internal links |
+| Service page | 3-5 internal links |
+| Category page | Links to all child pages |
+| Product page | 2-4 internal links |
+
+### Anchor Text Rules
+- Use descriptive anchor text (not "click here")
+- Vary anchor text (don't always use exact match keywords)
+- Link to relevant, related content
+- Ensure no orphan pages (every page linked from at least one other page)
+
+---
+
+## Content Freshness Signals
+
+| Content Type | Update Frequency |
+|--------------|------------------|
+| News/current events | Within hours/days |
+| Blog posts (evergreen) | Review annually |
+| Product pages | When specs change |
+| Service pages | Review quarterly |
+| Company info | When changes occur |
+
+### Required Elements
+- Publication date visible (for articles/blogs)
+- Last updated date (if significantly revised)
+- Changelog for major updates (optional but good)

package/skills/global_config/seo/references/schema-types.md

@@ -0,0 +1,118 @@
+<!-- Updated: 2026-02-07 -->
+# Schema.org Types: Status & Recommendations (February 2026)
+
+**Schema.org Version:** 29.4 (December 8, 2025)
+
+## Format Preference
+Always use **JSON-LD** (`<script type="application/ld+json">`).
+Google's documentation explicitly recommends JSON-LD over Microdata and RDFa.
+
+**AI Search Note:** Content with proper schema has ~2.5× higher chance of appearing in AI-generated answers (confirmed by Google and Microsoft, March 2025).
+
+---
+
+## Active: Recommend freely
+
+| Type | Use Case | Key Properties |
+|------|----------|----------------|
+| Organization | Company info | name, url, logo, contactPoint, sameAs |
+| LocalBusiness | Physical businesses | name, address, telephone, openingHours, geo, priceRange |
+| SoftwareApplication | Desktop/mobile apps | name, operatingSystem, applicationCategory, offers, aggregateRating |
+| WebApplication | Browser-based SaaS | name, applicationCategory, offers, browserRequirements, featureList |
+| Product | Physical/digital products | name, image, description, sku, brand, offers, review |
+| Offer | Pricing | price, priceCurrency, availability, url, validFrom |
+| Service | Service businesses | name, provider, areaServed, description, offers |
+| Article | Blog posts, news | headline, author, datePublished, dateModified, image, publisher |
+| BlogPosting | Blog content | Same as Article + blog-specific context |
+| NewsArticle | News content | Same as Article + news-specific context |
+| Review | Individual reviews | reviewRating, author, itemReviewed, reviewBody |
+| AggregateRating | Rating summaries | ratingValue, reviewCount, bestRating, worstRating |
+| BreadcrumbList | Navigation | itemListElement with position, name, item |
+| WebSite | Site-level | name, url, potentialAction (SearchAction for sitelinks search) |
+| WebPage | Page-level | name, description, datePublished, dateModified |
+| Person | Author/team | name, jobTitle, url, sameAs, image, worksFor |
+| ContactPage | Contact pages | name, url |
+| VideoObject | Video content | name, description, thumbnailUrl, uploadDate, duration, contentUrl |
+| ImageObject | Image content | contentUrl, caption, creator, copyrightHolder |
+| Event | Events | name, startDate, endDate, location, organizer, offers |
+| JobPosting | Job listings | title, description, datePosted, hiringOrganization, jobLocation |
+| Course | Educational content | name, description, provider, hasCourseInstance |
+| DiscussionForumPosting | Forum threads | headline, author, datePublished, text, url |
+| ProductGroup | Variant products | name, productGroupID, variesBy, hasVariant |
+| ProfilePage | Author/creator profiles | mainEntity (Person), name, url, description, sameAs |
+
+---
+
+## Restricted: Only for specific site types
+
+| Type | Restriction | Since |
+|------|------------|-------|
+| FAQPage | Government and healthcare authority sites ONLY | August 2023 |
+
+> Google severely limited FAQ rich results in August 2023. Only authoritative sources (government, health organizations) receive FAQ rich results.
+>
+> **GEO nuance**: FAQPage schema still benefits AI/LLM citation visibility (ChatGPT, Perplexity, Google AI Overviews), even without Google rich results.
+> - **Existing FAQPage on commercial site**: Flag at Info priority, not Critical. Removal removes GEO citation upside.
+> - **Adding new FAQPage**: Not recommended for Google benefit; acceptable if AI search visibility is a priority.
+
+---
+
+## Deprecated: Never recommend
+
+| Type | Status | Since | Notes |
+|------|--------|-------|-------|
+| HowTo | Rich results fully removed | September 2023 | Google stopped showing how-to rich results |
+| SpecialAnnouncement | Deprecated | July 31, 2025 | COVID-era schema, no longer processed |
+| CourseInfo | Retired from rich results | June 2025 | Merged into Course |
+| EstimatedSalary | Retired from rich results | June 2025 | No longer displayed |
+| LearningVideo | Retired from rich results | June 2025 | Use VideoObject instead |
+| ClaimReview | Retired from rich results | June 2025 | Fact-check markup no longer generates rich results |
+| VehicleListing | Retired from rich results | June 2025 | Vehicle listing structured data discontinued |
+| Book Actions | Deprecated then REVERSED | June 2025 | **Still functional as of Feb 2026**: historical note only |
+| Practice Problem | Retired from rich results | Late 2025 | Educational practice problems no longer displayed |
+| Dataset | Retired from rich results | Late 2025 | Dataset Search feature discontinued |
+
+---
+
+## Recent Additions (2024-2026)
+
+| Type/Feature | Added | Notes |
+|-------------|-------|-------|
+| Product Certification markup | April 2025 | Energy ratings, safety certifications. Replaced EnergyConsumptionDetails. |
+| ProductGroup | 2025 | E-commerce product variants with variesBy, hasVariant properties |
+| ProfilePage | 2025 | Author/creator profile pages with mainEntity Person for E-E-A-T |
+| DiscussionForumPosting | 2024 | For forum/community content |
+| Speakable | Updated 2024 | For voice search optimization |
+| LoyaltyProgram | June 2025 | Member pricing, loyalty card structured data |
+| Organization-level shipping/return policies | November 2025 | Configure via Search Console without Merchant Center |
+| ConferenceEvent | December 2025 | Schema.org v29.4 addition |
+| PerformingArtsEvent | December 2025 | Schema.org v29.4 addition |
+
+## E-commerce Requirements (Updated)
+
+| Requirement | Status | Since |
+|-------------|--------|-------|
+| `returnPolicyCountry` in MerchantReturnPolicy | **Required** | March 2025 |
+| Product variant structured data | Expanded | 2025, includes apparel, cosmetics, electronics |
+
+> **Note:** Content API for Shopping sunsets August 18, 2026. Migrate to Merchant API.
+
+---
+
+## Validation Checklist
+
+For any schema block, verify:
+
+1. ✅ `@context` is `"https://schema.org"` (not http)
+2. ✅ `@type` is a valid, non-deprecated type
+3. ✅ All required properties are present
+4. ✅ Property values match expected data types
+5. ✅ No placeholder text (e.g., "[Business Name]")
+6. ✅ URLs are absolute, not relative
+7. ✅ Dates are in ISO 8601 format
+8. ✅ Images have valid URLs
+
+## Testing Tools
+
+- [Google Rich Results Test](https://search.google.com/test/rich-results)
+- [Schema.org Validator](https://validator.schema.org/)