vibes-plug 1.0.0

package/skills/seo/SKILL.md

@@ -0,0 +1,225 @@
+---
+name: seo
+description: "Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO / Audit SEO menyeluruh (Technical, On-Page, Schema, Sitemap, E-E-A-T, GEO)"
+author: "Roedy Rustam"
+---
+
+# SEO Expert (2026 — AI Mode & Core Web Vitals Edition)
+
+[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
+
+---
+
+<a name="english"></a>
+## English
+
+### Description
+Comprehensive SEO audit covering technical SEO, on-page optimization, structured data, sitemaps, Core Web Vitals, E-E-A-T signals, and **Generative Engine Optimization (GEO)** for AI-powered search (Google AI Mode, ChatGPT Search, Perplexity).
+
+### Trigger Conditions
+- Running a full SEO audit on an existing web application.
+- Optimizing technical SEO for a new Next.js / Astro site.
+- Adding structured data (JSON-LD) for rich results and AI citation.
+- Optimizing Core Web Vitals (LCP, INP, CLS).
+- Preparing a site for Google AI Mode and ChatGPT Search indexing.
+- Setting up a sitemap and `robots.txt`.
+
+### 2026 SEO Landscape Changes
+
+| 2024 (Old) | 2026 (Current) |
+|---|---|
+| AI Overviews (SGE) | **Google AI Mode** — integrated AI answers |
+| FID metric (deprecated) | **INP** (Interaction to Next Paint) |
+| Keyword density focus | **Topical authority + E-E-A-T** |
+| Backlinks only | **Citations in AI responses** |
+| `robots.txt` only | `robots.txt` + **`/llms.txt`** |
+
+### Technical SEO Checklist
+
+#### Core Web Vitals (2026 Targets)
+```
+LCP (Largest Contentful Paint) < 2.5s
+INP (Interaction to Next Paint) < 200ms   ← replaced FID
+CLS (Cumulative Layout Shift)  < 0.1
+TTFB (Time to First Byte)      < 600ms
+```
+
+**INP Optimization** (the new critical metric):
+```typescript
+// INP is degraded by long tasks blocking the main thread
+// Solution: Use React's useTransition to defer non-critical updates
+import { useTransition } from 'react';
+
+function SearchInput() {
+  const [isPending, startTransition] = useTransition();
+
+  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    startTransition(() => {
+      // Defer the expensive filtering to not block INP
+      setFilteredResults(filterData(e.target.value));
+    });
+  };
+  return <input onChange={handleChange} />;
+}
+```
+
+#### Crawlability & Indexing
+```typescript
+// Next.js 15 — metadata API for complete SEO
+// app/layout.tsx
+export const metadata: Metadata = {
+  metadataBase: new URL('https://myapp.com'),
+  title: {
+    default: 'My SaaS — One-line value proposition',
+    template: '%s | My SaaS',
+  },
+  description: '150 characters max. Include primary keyword naturally.',
+  openGraph: {
+    type: 'website',
+    url: 'https://myapp.com',
+    siteName: 'My SaaS',
+    images: [{ url: '/og.png', width: 1200, height: 630 }],
+  },
+  twitter: { card: 'summary_large_image', creator: '@handle' },
+  robots: { index: true, follow: true },
+  alternates: { canonical: 'https://myapp.com' },
+};
+```
+
+```typescript
+// Dynamic sitemap.ts (Next.js App Router)
+// app/sitemap.ts
+import { MetadataRoute } from 'next';
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const posts = await getBlogPosts();
+  
+  return [
+    { url: 'https://myapp.com', lastModified: new Date(), changeFrequency: 'weekly', priority: 1 },
+    { url: 'https://myapp.com/features', lastModified: new Date(), changeFrequency: 'monthly', priority: 0.8 },
+    ...posts.map(p => ({
+      url: `https://myapp.com/blog/${p.slug}`,
+      lastModified: new Date(p.updatedAt),
+      changeFrequency: 'monthly' as const,
+      priority: 0.6,
+    })),
+  ];
+}
+```
+
+### Structured Data (JSON-LD) for AI Citation
+```html
+<!-- Organization schema — establishes brand entity -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  "name": "My SaaS",
+  "url": "https://myapp.com",
+  "logo": "https://myapp.com/logo.png",
+  "sameAs": [
+    "https://twitter.com/myapp",
+    "https://linkedin.com/company/myapp"
+  ],
+  "contactPoint": {
+    "@type": "ContactPoint",
+    "contactType": "customer support",
+    "email": "support@myapp.com"
+  }
+}
+</script>
+
+<!-- SoftwareApplication schema for SaaS products -->
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "SoftwareApplication",
+  "name": "My SaaS",
+  "applicationCategory": "BusinessApplication",
+  "operatingSystem": "Web",
+  "offers": {
+    "@type": "Offer",
+    "price": "0",
+    "priceCurrency": "USD",
+    "description": "Free tier available"
+  },
+  "aggregateRating": {
+    "@type": "AggregateRating",
+    "ratingValue": "4.8",
+    "reviewCount": "247"
+  }
+}
+</script>
+```
+
+### GEO — Google AI Mode Optimization
+Google AI Mode (formerly AI Overviews) now powers the top of search results:
+- **Be the source**: Write comprehensive, authoritative content on your core topics.
+- **Q&A format**: Structure content as questions and answers — AI Mode quotes these directly.
+- **Factual and specific**: Include statistics, named entities, and dates.
+- **`/llms.txt`**: Add an AI-readable site index (see `seo-geo` skill).
+- **Speed**: AI Mode favors fast-loading pages (TTFB < 600ms).
+
+### On-Page SEO Standards
+```
+H1: One per page — primary keyword, compelling, < 60 chars
+H2: Section headers — secondary keywords
+H3: Sub-sections — long-tail keywords, FAQ answers
+Meta Title: < 60 chars — keyword + brand
+Meta Description: < 155 chars — keyword + CTA + benefit
+URL: lowercase, hyphens, keyword-in-slug, < 5 segments
+Images: Descriptive alt text, WebP format, lazy loading
+Internal links: 3-5 per long-form page to related content
+```
+
+---
+
+<a name="bahasa-indonesia"></a>
+## Bahasa Indonesia
+
+### Deskripsi
+Audit SEO komprehensif mencakup SEO teknikal, optimasi on-page, data terstruktur, sitemap, Core Web Vitals, sinyal E-E-A-T, dan **Generative Engine Optimization (GEO)** untuk pencarian bertenaga AI (Google AI Mode, ChatGPT Search, Perplexity).
+
+### Kondisi Pemicu
+- Menjalankan audit SEO penuh pada aplikasi web yang ada.
+- Mengoptimalkan SEO teknikal untuk situs Next.js / Astro baru.
+- Menambahkan data terstruktur (JSON-LD) untuk rich result dan kutipan AI.
+- Mengoptimalkan Core Web Vitals (LCP, INP, CLS).
+- Mempersiapkan situs untuk indexing Google AI Mode dan ChatGPT Search.
+
+### Perubahan Lanskap SEO 2026
+
+| 2024 (Lama) | 2026 (Sekarang) |
+|---|---|
+| AI Overviews (SGE) | **Google AI Mode** — jawaban AI terintegrasi |
+| Metrik FID (dihentikan) | **INP** (Interaction to Next Paint) |
+| Fokus kepadatan keyword | **Otoritas topikal + E-E-A-T** |
+| Hanya backlink | **Kutipan dalam respons AI** |
+| Hanya `robots.txt` | `robots.txt` + **`/llms.txt`** |
+
+### Checklist SEO Teknikal
+
+#### Core Web Vitals (Target 2026)
+- LCP < 2.5 detik
+- **INP < 200ms** ← menggantikan FID
+- CLS < 0.1
+- TTFB < 600ms
+
+**Optimasi INP**: Metrik kritis baru yang mengukur responsivitas interaksi. Gunakan `useTransition` React untuk menunda pembaruan non-kritis agar tidak memblokir thread utama.
+
+#### Crawlability & Indexing
+Gunakan Metadata API Next.js 15 untuk SEO lengkap: `title`, `description`, `openGraph`, `twitter`, `robots`, `alternates.canonical`. Buat sitemap dinamis dengan `app/sitemap.ts` yang menyertakan semua halaman statis dan konten dinamis.
+
+### Data Terstruktur (JSON-LD) untuk Kutipan AI
+Tambahkan schema `Organization` untuk membangun entitas merek dan schema `SoftwareApplication` untuk produk SaaS — termasuk `aggregateRating` jika tersedia.
+
+### GEO — Optimasi Google AI Mode
+Google AI Mode (sebelumnya AI Overviews) kini mendukung bagian atas hasil pencarian:
+- Tulis konten yang komprehensif dan otoritatif tentang topik inti.
+- Strukturkan konten sebagai Q&A — AI Mode langsung mengutip ini.
+- Sertakan statistik, entitas bernama, dan tanggal.
+- Tambahkan `/llms.txt` sebagai indeks situs yang dapat dibaca AI.
+- Kecepatan: AI Mode lebih memilih halaman yang memuat cepat (TTFB < 600ms).
+
+### Standar SEO On-Page
+H1 satu per halaman, H2 untuk header seksi, meta title < 60 karakter, meta deskripsi < 155 karakter, URL lowercase dengan tanda hubung dan keyword di slug, alt text deskriptif untuk semua gambar, 3-5 internal link per halaman long-form.

package/skills/seo/references/cwv-thresholds.md

@@ -0,0 +1,108 @@
+<!-- Updated: 2026-02-07 -->
+# Core Web Vitals Thresholds (February 2026)
+
+## Current Metrics
+
+| Metric | Good | Needs Improvement | Poor |
+|--------|------|-------------------|------|
+| LCP (Largest Contentful Paint) | ≤2.5s | 2.5s–4.0s | >4.0s |
+| INP (Interaction to Next Paint) | ≤200ms | 200ms–500ms | >500ms |
+| CLS (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
+
+## Key Facts
+- INP replaced FID (First Input Delay) on **March 12, 2024**. FID was fully removed from all Chrome tools (CrUX API, PageSpeed Insights, Lighthouse) on **September 9, 2024**. INP is the sole interactivity metric.
+- Evaluation uses the **75th percentile** of real user data (field data from CrUX).
+- Google assesses at the **page level** and the **origin level**.
+- Core Web Vitals are a **tiebreaker** ranking signal: they matter most when content quality is similar between competitors.
+- **Thresholds unchanged since original definitions**: ignore claims of "tightened thresholds" from SEO blogs.
+- December 2025 core update appeared to weight **mobile CWV more heavily**.
+- As of October 2025: **57.1%** desktop sites and **49.7%** mobile sites pass all three CWV.
+
+## LCP Subparts (February 2025 CrUX Addition)
+
+LCP can now be broken into diagnostic subparts:
+
+| Subpart | What It Measures | Target |
+|---------|------------------|--------|
+| **TTFB** | Time to First Byte (server response) | <800ms |
+| **Resource Load Delay** | Time from TTFB to resource request start | Minimize |
+| **Resource Load Time** | Time to download the LCP resource | Depends on size |
+| **Element Render Delay** | Time from resource loaded to rendered | Minimize |
+
+**Total LCP = TTFB + Resource Load Delay + Resource Load Time + Element Render Delay**
+
+Use this breakdown to identify which phase is causing LCP issues.
+
+## Soft Navigations API (Experimental)
+
+**Chrome 139+ Origin Trial (July 2025)**: First step toward measuring CWV in SPAs.
+
+- Addresses the long-standing SPA measurement blind spot
+- Currently experimental, **no ranking impact yet**
+- Detects "soft navigations" (URL changes without full page load)
+- May affect future SPA CWV measurement
+
+**Detection:** Check for SPA frameworks (React, Vue, Angular, Svelte) and warn about current CWV measurement limitations.
+
+## Measurement Sources
+
+### Field Data (Real Users)
+- Chrome User Experience Report (CrUX)
+- PageSpeed Insights (uses CrUX data)
+- Search Console Core Web Vitals report
+
+### Lab Data (Simulated)
+- Lighthouse
+- WebPageTest
+- Chrome DevTools
+
+> Field data is what Google uses for ranking. Lab data is useful for debugging.
+
+## Common Bottlenecks
+
+### LCP (Largest Contentful Paint)
+- Unoptimized hero images (compress, use WebP/AVIF, add preload)
+- Render-blocking CSS/JS (defer, async, critical CSS inlining)
+- Slow server response (TTFB >200ms: use edge CDN, caching)
+- Third-party script blocking (defer analytics, chat widgets)
+- Web font loading delay (use font-display: swap + preload)
+
+### INP (Interaction to Next Paint)
+- Long JavaScript tasks on main thread (break into smaller tasks <50ms)
+- Heavy event handlers (debounce, use requestAnimationFrame)
+- Excessive DOM size (>1,500 elements is concerning)
+- Third-party scripts hijacking main thread
+- Synchronous XHR or localStorage operations
+- Layout thrashing (multiple forced reflows)
+
+### CLS (Cumulative Layout Shift)
+- Images/iframes without width/height dimensions
+- Dynamically injected content above existing content
+- Web fonts causing layout shift (use font-display: swap + preload)
+- Ads/embeds without reserved space
+- Late-loading content pushing down the page
+
+## Optimization Priority
+
+1. **LCP**: Most impactful for perceived performance
+2. **CLS**: Most common issue affecting user experience
+3. **INP**: Matters most for interactive applications
+
+## Tools
+
+```bash
+# PageSpeed Insights API
+curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=URL&key=API_KEY"
+
+# Lighthouse CLI
+npx lighthouse URL --output json --output-path report.json
+```
+
+## Performance Tooling Updates (2025)
+
+- **Lighthouse 13.0** (October 2025): Major audit restructuring with reorganized performance categories and updated scoring weights. Lighthouse is a lab tool (simulated conditions): always cross-reference with CrUX field data for real-world performance.
+- **CrUX Vis** replaced the CrUX Dashboard (November 2025). The old Looker Studio dashboard was deprecated. Use [CrUX Vis](https://cruxvis.withgoogle.com) or the CrUX API directly.
+- **LCP subparts** added to CrUX (February 2025): Time to First Byte (TTFB), resource load delay, resource load time, and element render delay are now available as sub-components of LCP in CrUX data.
+- **Google Search Console 2025 features** (December 2025): AI-powered configuration for automated analysis. Branded vs. non-branded queries filter. Hourly data available in API. Custom chart annotations. Social channels tracking.
+
+> **Mobile-first indexing** is 100% complete as of July 5, 2024. Google now crawls and indexes ALL websites exclusively with the mobile Googlebot user-agent. Ensure your mobile version contains all critical content, structured data, and meta tags.

package/skills/seo/references/eeat-framework.md

@@ -0,0 +1,214 @@
+# E-E-A-T Evaluation Framework
+## Updated per Google Quality Rater Guidelines: September 11, 2025
+## Plus December 2025 Core Update Implications
+
+## Overview
+
+E-E-A-T = **E**xperience, **E**xpertise, **A**uthoritativeness, **T**rustworthiness
+
+Trustworthiness is the most important factor. It is assessed based on the
+other three signals plus direct trust indicators.
+
+## CRITICAL: December 2025 Core Update
+
+> **E-E-A-T now applies to ALL competitive queries, not just YMYL.**
+
+The December 2025 core update was described as a "watershed moment" that:
+- Extended E-E-A-T evaluation to virtually all competitive queries
+- Made author attribution standards tighter across all categories
+- Penalized anonymous or generic authorship even for non-YMYL content
+- Significantly improved AI content quality detection
+
+**Impact by industry:**
+| Industry | Traffic Drops |
+|----------|--------------|
+| Affiliate sites | 71% average decline |
+| Health/YMYL | 67% average decline |
+| E-commerce | 52% average decline |
+
+**Key takeaway:** Even entertainment and lifestyle content now requires demonstrated expertise. Generic content no longer ranks.
+
+## YMYL (Your Money or Your Life)
+
+Topics requiring **highest** E-E-A-T standards (but E-E-A-T now matters everywhere):
+- Health and safety
+- Financial advice and transactions
+- Legal information
+- News and current events
+- **Elections and civic trust** (added Sept 2025)
+- **Democratic processes** (added Sept 2025)
+- Groups of people (potential for harm)
+
+---
+
+## Experience (Weight: 20%)
+
+First-hand knowledge and personal involvement with the topic.
+
+### Signals to Check
+- [ ] Author has demonstrable first-hand experience with the topic
+- [ ] Content includes original photos, screenshots, or data
+- [ ] Case studies or real-world examples with specific details
+- [ ] Personal process documentation or methodology descriptions
+- [ ] Before/after results or outcome data
+- [ ] Specific anecdotes that couldn't be fabricated
+
+### Scoring
+- **Strong**: Multiple first-hand experience signals, original content
+- **Moderate**: Some personal experience evident
+- **Weak**: Generic information, no personal touch
+- **None**: Clearly AI-generated or scraped content
+
+---
+
+## Expertise (Weight: 25%)
+
+Formal qualifications, training, and demonstrated knowledge.
+
+### Signals to Check
+- [ ] Author credentials relevant to topic (bio, certifications)
+- [ ] Technical accuracy and depth appropriate for audience
+- [ ] Claims supported by evidence or sources
+- [ ] Specialized vocabulary used correctly
+- [ ] Up-to-date with current developments in the field
+- [ ] Byline with author name and credentials visible
+
+### Scoring
+- **Strong**: Verified credentials, deep technical accuracy
+- **Moderate**: Demonstrable knowledge, some credentials
+- **Weak**: Surface-level information, no credentials
+- **None**: Factual errors, misinformation
+
+---
+
+## Authoritativeness (Weight: 25%)
+
+Recognition by others as a go-to source.
+
+### Signals to Check
+- [ ] Site recognized as authority in its niche
+- [ ] Author recognized as expert (external citations, speaking, publications)
+- [ ] Content cited by other authoritative sources
+- [ ] Industry awards, certifications, or accreditations
+- [ ] Consistent publication history in the topic area
+- [ ] Featured in reputable media outlets
+- [ ] Professional affiliations
+
+### Scoring
+- **Strong**: Widely recognized authority, cited by others
+- **Moderate**: Growing recognition, some external validation
+- **Weak**: No external recognition
+- **None**: Negative reputation, known for misinformation
+
+---
+
+## Trustworthiness (Weight: 30%)
+
+The most important factor, overall reliability and transparency.
+
+### Signals to Check
+- [ ] Clear contact information (physical address, phone, email)
+- [ ] Privacy policy and terms of service
+- [ ] HTTPS with valid certificate
+- [ ] Transparent about who creates content and why
+- [ ] Customer reviews and testimonials
+- [ ] Corrections and update history visible
+- [ ] No deceptive practices (hidden ads, clickbait)
+- [ ] Secure payment processing (for e-commerce)
+- [ ] Return/refund policy visible
+
+### Scoring
+- **Strong**: Full transparency, verified business, positive reputation
+- **Moderate**: Good trust signals, minor gaps
+- **Weak**: Missing key trust signals
+- **None**: Deceptive practices, scam indicators
+
+---
+
+## September 2025 QRG Updates
+
+### AI Content Assessment
+Raters now formally evaluate whether content appears AI-generated:
+- AI content is **acceptable** if it demonstrates genuine E-E-A-T
+- Low-quality AI content (generic, no unique value) is penalized
+- The presence of AI-generated content is not inherently penalizing
+- What matters: does the content provide unique value regardless of creation method?
+
+### Markers of Low-Quality AI Content
+- Generic phrasing without specificity
+- Lack of original insight or unique perspective
+- No first-hand experience signals
+- Factual inaccuracies
+- Repetitive structure across multiple pages
+- No author attribution or expertise signals
+
+### New Spam Categories
+- **Expired domain abuse**: Buying expired domains for their backlinks
+- **Site reputation abuse**: Using reputable site to host low-quality content
+- **Scaled content abuse**: Mass-producing content without value
+
+### AI Overview Evaluation
+Raters assess quality of AI-generated summaries in search results.
+
+### RSL 1.0 (Really Simple Licensing)
+New machine-readable content licensing standard (December 2025) for AI training:
+- Backed by: Reddit, Yahoo, Medium, Quora, Cloudflare, Akamai, Creative Commons
+- Allows publishers to specify AI licensing terms
+- Augments robots.txt for AI-specific permissions
+
+---
+
+## Experience Signals Are Critical Differentiators
+
+The December 2025 update elevated the "Experience" dimension as a key differentiator:
+- First-person narrative ("I tested this...", "In my experience...")
+- Original photos and screenshots (not stock images)
+- Specific examples with verifiable details
+- Process documentation showing actual work done
+
+**Why:** AI can generate expertise-sounding content but cannot fabricate genuine experience.
+
+---
+
+## Overall Scoring Guide
+
+| Score | Description |
+|-------|-------------|
+| 90-100 | Exceptional E-E-A-T, authority site, recognized expert, full transparency |
+| 70-89 | Strong E-E-A-T, demonstrated expertise, good trust signals |
+| 50-69 | Moderate E-E-A-T, some signals, room for improvement |
+| 30-49 | Weak E-E-A-T, minimal signals, significant gaps |
+| 0-29 | Very low E-E-A-T, no visible signals, potential trust issues |
+
+---
+
+## Improvement Recommendations by Score
+
+### 0-29 (Critical)
+1. Add contact information and about page
+2. Establish author identity with credentials
+3. Implement HTTPS
+4. Remove deceptive elements
+
+### 30-49 (Major)
+1. Add author bios with credentials
+2. Include first-hand experience content
+3. Get external citations/mentions
+4. Add customer testimonials
+
+### 50-69 (Moderate)
+1. Deepen content with original research
+2. Build topical authority through content clusters
+3. Pursue industry recognition
+4. Document processes and methodologies
+
+### 70-89 (Minor)
+1. Maintain freshness with regular updates
+2. Expand author presence across platforms
+3. Pursue speaking/publication opportunities
+4. Add video/multimedia demonstrating expertise
+
+### 90-100 (Maintenance)
+1. Continue publishing high-quality content
+2. Monitor and respond to reputation issues
+3. Keep credentials and certifications current

package/skills/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)