claude-plugin-wordpress-manager 2.3.1 → 2.6.0

package/skills/wp-content-optimization/references/content-freshness.md

@@ -0,0 +1,234 @@
+# Content Freshness Audit
+
+## Overview
+
+Content freshness measures how current and accurate published content remains over time. Search engines factor freshness into rankings, and stale content can erode traffic and authority. Claude performs content freshness audits by analyzing publish dates, modification history, traffic trends from GSC, and content accuracy — then classifies content into refresh priorities. This workflow uses `list_content`, `get_content`, and GSC tools.
+
+## Content Decay Patterns
+
+### What Is Content Decay
+Content decay occurs when a page gradually loses organic traffic over time due to:
+- Newer, more comprehensive competitor content
+- Outdated statistics, data, or references
+- Changed search intent for target keywords
+- Algorithm updates favoring fresher content
+- Broken links or outdated external references
+
+### Decay Timeline
+
+| Content Age | Risk Level | Typical Action |
+|-------------|-----------|----------------|
+| 0-6 months | Low | Monitor, no action needed |
+| 6-12 months | Medium | Review for accuracy, consider minor updates |
+| 12-18 months | High | Data refresh, section updates required |
+| 18-24 months | Very High | Major refresh or rewrite |
+| 24+ months | Critical | Full rewrite, republish, or archive |
+
+### Decay Signals
+Indicators that content is decaying:
+1. **Traffic decline** — steady month-over-month drop in organic traffic (via GSC)
+2. **Position drops** — average position worsening for target keywords
+3. **Impression decline** — fewer impressions means less search visibility
+4. **Bounce rate increase** — users leaving quickly (content not meeting expectations)
+5. **Outdated references** — statistics from 2+ years ago, dead links
+
+## Freshness Signals
+
+### What Search Engines Evaluate
+
+| Signal | Description | WordPress Field |
+|--------|-------------|-----------------|
+| Published date | Original publication date | `date` |
+| Modified date | Last content modification | `modified` |
+| Content changes | Actual meaningful edits (not cosmetic) | Content diff |
+| Data currency | Statistics and facts are current | Manual check |
+| Link freshness | External links still active and current | Automated check |
+
+### Meaningful vs Cosmetic Updates
+```
+Meaningful updates (search engines recognize):
+- Adding new sections or paragraphs
+- Updating statistics and data points
+- Adding new examples or case studies
+- Expanding topic coverage
+- Updating recommendations based on new information
+
+Cosmetic updates (do NOT count as fresh):
+- Changing the date without content changes
+- Fixing typos or minor formatting
+- Rearranging existing content
+- Adding images without new text
+- Changing the author
+```
+
+## Refresh Strategies
+
+### Strategy 1: Date and Data Refresh
+**When to use:** Content is fundamentally sound but contains outdated numbers or references.
+```
+Effort: Low (30 min - 1 hour)
+Impact: Medium
+Actions:
+- Update statistics with current data
+- Replace outdated year references
+- Verify all external links still work
+- Update the modified date
+```
+
+### Strategy 2: Section Expansion
+**When to use:** Content covers the topic but competitors have more depth.
+```
+Effort: Medium (1-3 hours)
+Impact: High
+Actions:
+- Add 1-3 new sections addressing gaps
+- Add FAQ section based on current search queries
+- Include updated examples or case studies
+- Add internal links to newer related content
+```
+
+### Strategy 3: Full Rewrite
+**When to use:** Content is outdated, poorly structured, or fundamentally off-target.
+```
+Effort: High (3-6 hours)
+Impact: Very High
+Actions:
+- Rewrite from scratch with current keyword research
+- Maintain the same URL (preserve any existing backlinks)
+- Update all meta elements (title, description)
+- Republish with current date
+- Submit to GSC for re-indexing
+```
+
+### Strategy 4: Republish
+**When to use:** Content is significantly updated and should be treated as new.
+```
+Effort: Medium (after rewrite)
+Impact: High
+Actions:
+- Change publish date to current date
+- Share on social channels as new content
+- Update internal links pointing to this page
+- Submit URL to GSC for re-crawling
+```
+
+### Strategy 5: Archive / Redirect
+**When to use:** Content has no traffic, no keyword value, and no update potential.
+```
+Effort: Low
+Impact: Positive (reduces index bloat)
+Actions:
+- Set up 301 redirect to the most relevant active page
+- Or add noindex meta tag
+- Remove from XML sitemap
+- Remove internal links pointing to this page
+```
+
+## Evergreen vs Temporal Content
+
+### Classification
+
+| Type | Characteristics | Freshness Need | Examples |
+|------|----------------|----------------|----------|
+| Evergreen | Topic stays relevant, answers don't change | Low (annual review) | "How to Install WordPress", "What Is SEO" |
+| Semi-Evergreen | Core topic stable, details change | Medium (6-12 months) | "Best WordPress Plugins 2026", "WordPress Security Guide" |
+| Temporal | Time-bound, loses relevance quickly | High (monthly or event-based) | "WordPress 6.5 New Features", "Black Friday Deals 2026" |
+| News | Immediate relevance, short lifespan | Not refreshable | "WordPress Acquires Company X" |
+
+### Strategy by Content Type
+
+| Type | Refresh Strategy | Frequency |
+|------|-----------------|-----------|
+| Evergreen | Minor data updates, link checks | Every 12 months |
+| Semi-Evergreen | Section expansion, data refresh | Every 6-12 months |
+| Temporal | Full rewrite for new period or archive | When period expires |
+| News | Archive (301 to evergreen resource) | When news cycle ends |
+
+## Content Freshness Audit Workflow
+
+### Step 1: Inventory All Content
+```
+Use list_content to fetch all published posts and pages.
+Collect: post ID, title, URL, publish date, modified date, category.
+Sort by publish date (oldest first).
+```
+
+### Step 2: Calculate Content Age
+```
+For each content piece:
+- Age = current date - publish date
+- Days since last update = current date - modified date
+- Flag: age > 12 months AND no modification in 6+ months
+```
+
+### Step 3: Pull Traffic Trends (GSC)
+```
+Use gsc_page_performance for each page (or top pages by age).
+Compare last 3 months vs previous 3 months:
+- Traffic trend: growing, stable, or declining
+- Position trend: improving, stable, or worsening
+- CTR trend: improving, stable, or declining
+```
+
+### Step 4: Classify Each Content Piece
+```
+For each piece of content, assign a freshness category:
+
+| Category | Criteria |
+|----------|---------|
+| Fresh | <6 months old OR recently updated with growing traffic |
+| Aging | 6-12 months, stable traffic, no recent updates |
+| Stale | 12-18 months, declining traffic, no updates |
+| Decayed | 18+ months, significant traffic loss |
+| Dead | 24+ months, near-zero traffic, no keyword rankings |
+```
+
+### Step 5: Assign Refresh Priority
+```
+Priority 1 (Urgent): Stale content with high historical traffic → quick refresh
+Priority 2 (High):   Aging content in important categories → preventive refresh
+Priority 3 (Medium): Decayed content with some keyword potential → rewrite
+Priority 4 (Low):    Dead content with no recovery potential → archive/redirect
+```
+
+### Step 6: Generate Audit Report
+```
+Content Freshness Audit Report
+══════════════════════════════
+Total Content Pieces: 85
+Fresh (0-6 months):    12 (14%)
+Aging (6-12 months):   23 (27%)
+Stale (12-18 months):  28 (33%)
+Decayed (18-24 months): 15 (18%)
+Dead (24+ months):       7 (8%)
+
+Priority Actions:
+┌─────────┬────────────────────────────────────┬───────────┬──────────────┐
+│ Priority│ Content                            │ Age       │ Action       │
+├─────────┼────────────────────────────────────┼───────────┼──────────────┤
+│ 1       │ "WordPress Speed Guide"            │ 14 months │ Data refresh │
+│ 1       │ "Best WooCommerce Plugins"         │ 16 months │ Rewrite      │
+│ 2       │ "How to Install WordPress"         │ 10 months │ Review       │
+│ 4       │ "WordPress 5.9 Features"           │ 26 months │ Archive      │
+└─────────┴────────────────────────────────────┴───────────┴──────────────┘
+```
+
+### Step 7: Execute Refresh Plan
+For each priority item, apply the appropriate refresh strategy:
+```
+Use get_content to fetch the full content.
+Apply the selected refresh strategy (data refresh, expansion, rewrite).
+Use update_content to publish the updated version.
+Submit refreshed URLs to GSC for re-crawling if significantly changed.
+```
+
+## Best Practices
+
+- Run freshness audits quarterly (every 3 months) for sites with 50+ posts
+- Prioritize high-traffic decaying content over zero-traffic content
+- Always refresh meaningfully — date-only changes do not fool search engines
+- Track content age as a standard metric alongside traffic and rankings
+- Set calendar reminders for semi-evergreen content refresh cycles
+- When refreshing, also update internal links from other posts pointing to the refreshed content
+- Keep a content calendar that includes refresh dates alongside new content publication
+- Consider combining freshness audits with the Bulk Content Triage procedure (SKILL.md Section 6) for comprehensive content management

package/skills/wp-content-optimization/references/headline-optimization.md

@@ -0,0 +1,171 @@
+# Headline Optimization
+
+## Overview
+
+Headlines are the single most impactful element for both search CTR and on-page engagement. Claude performs headline analysis by evaluating keyword placement, emotional impact, clarity, length, and formula adherence — then generates scored alternatives. No external headline analyzer APIs are needed.
+
+## Headline Scoring Criteria (1-10 Scale)
+
+| Score | Criteria | Weight |
+|-------|----------|--------|
+| 0-2 | Keyword presence (primary keyword in title) | 20% |
+| 0-2 | Power word usage (emotional/urgency/curiosity) | 20% |
+| 0-2 | Length optimization (50-60 chars for SEO, 6-12 words) | 20% |
+| 0-2 | Clarity and specificity (reader knows what to expect) | 20% |
+| 0-2 | Formula adherence (matches proven headline pattern) | 20% |
+
+### Score Interpretation
+
+| Score | Rating | Action |
+|-------|--------|--------|
+| 9-10 | Excellent | No changes needed |
+| 7-8 | Good | Minor tweaks for improvement |
+| 5-6 | Average | Rewrite recommended |
+| 3-4 | Below Average | Rewrite required |
+| 1-2 | Poor | Complete headline overhaul |
+
+## Power Word Categories
+
+### Emotional Words
+- Trust: proven, guaranteed, authentic, certified, trusted
+- Fear: warning, dangerous, mistake, avoid, never
+- Joy: amazing, incredible, brilliant, stunning, remarkable
+- Surprise: secret, shocking, unexpected, little-known, hidden
+
+### Urgency Words
+- Time: now, today, immediately, hurry, limited, deadline
+- Scarcity: exclusive, rare, only, last chance, while supplies last
+- Action: act, rush, grab, claim, don't miss
+
+### Curiosity Words
+- Mystery: secret, hidden, little-known, underground, insider
+- Question: why, how, what if, did you know, ever wonder
+- Incomplete: the real reason, what nobody tells you, the truth about
+
+### Value Words
+- Benefit: free, save, boost, increase, maximize, transform
+- Ease: simple, easy, quick, effortless, step-by-step, beginner
+- Authority: ultimate, complete, definitive, comprehensive, expert
+
+## Headline Formulas
+
+### How-To Formula
+```
+How to [Achieve Desired Result] [Without Undesired Outcome]
+```
+Examples:
+- "How to Optimize WordPress Speed Without Plugins"
+- "How to Write SEO Headlines That Actually Get Clicks"
+
+### List Formula
+```
+[Number] [Adjective] [Keyword] [Promise/Benefit]
+```
+Examples:
+- "7 Proven Ways to Improve Your WordPress Page Speed"
+- "15 Essential WordPress Plugins for Small Business"
+
+### Question Formula
+```
+[Question Word] [Keyword] [Intriguing Element]?
+```
+Examples:
+- "Why Is Your WordPress Site So Slow? (And How to Fix It)"
+- "What Makes the Best WordPress Themes Actually Convert?"
+
+### Comparison Formula
+```
+[Option A] vs [Option B]: [Decisive Factor]
+```
+Examples:
+- "Yoast vs Rank Math: Which SEO Plugin Actually Performs Better?"
+- "WooCommerce vs Shopify: The Complete 2026 Comparison"
+
+### Result Formula
+```
+[Action] That [Specific Result] in [Timeframe]
+```
+Examples:
+- "WordPress Caching Setup That Cuts Load Time by 60% in 10 Minutes"
+- "SEO Fixes That Doubled Our Organic Traffic in 30 Days"
+
+## Keyword Placement Rules
+
+1. **Front-load the keyword** — primary keyword in the first 3-4 words
+2. **Natural phrasing** — keyword must read naturally, not forced
+3. **Exact match first** — try exact keyword match; partial match as fallback
+4. **Avoid keyword stuffing** — keyword appears once in the headline
+5. **Brand at the end** — if including brand name, use pipe separator at end
+
+### Examples
+```
+Good: "WordPress Speed Optimization: 10 Proven Techniques"
+       ^ keyword at front
+
+Bad:  "10 Proven Techniques for Making Your WordPress Website Speed Faster"
+       ^ keyword buried, awkward phrasing
+```
+
+## A/B Title Generation Workflow
+
+### Step 1: Fetch Current Title
+```
+Use list_content to get the current post title and slug.
+```
+
+### Step 2: Analyze Current Title
+Claude evaluates the title against the scoring criteria above and assigns a score.
+
+### Step 3: Generate 3 Alternatives
+Claude generates three headline variants using different formulas:
+- Variant A: Same formula, optimized (improve power words, keyword placement)
+- Variant B: Different formula (e.g., if original is How-To, try List)
+- Variant C: Curiosity-driven variant (question or result formula)
+
+### Step 4: Score All Variants
+Each variant receives a 1-10 score with per-criteria breakdown.
+
+### Step 5: Apply Best Option
+```
+Use update_content to set the winning title.
+Track the change for future CTR comparison via GSC data.
+```
+
+## Example Workflow
+
+### Input
+```
+Current title: "Tips for WordPress"
+Target keyword: "WordPress performance optimization"
+```
+
+### Analysis
+```
+Score: 2/10
+- Keyword presence: 0/2 (target keyword missing)
+- Power words: 0/2 (none)
+- Length: 0/2 (too short — 3 words)
+- Clarity: 1/2 (vague, no specificity)
+- Formula: 1/2 (implied list, but no number)
+```
+
+### Generated Alternatives
+```
+Variant A (List):     "9 WordPress Performance Optimization Tips That Actually Work" → 8/10
+Variant B (How-To):   "How to Master WordPress Performance Optimization in 2026" → 7/10
+Variant C (Result):   "WordPress Performance Optimization: Cut Load Time by 50%" → 9/10
+```
+
+### Recommendation
+Apply Variant C — highest score, strong keyword placement, specific result promise, power word ("cut"), appropriate length (56 chars).
+
+## Best Practices
+
+- Always preserve the primary keyword when rewriting headlines
+- Test one title change at a time to measure impact via GSC CTR data
+- Wait 2-4 weeks after title change before evaluating CTR impact
+- Keep headline under 60 characters for full display in search results
+- Use numbers when possible (odd numbers perform slightly better)
+- Front-load the most important information
+- Avoid clickbait — headline must accurately represent content
+- Consider the search intent behind the target keyword when choosing formula

package/skills/wp-content-optimization/references/meta-optimization.md

@@ -0,0 +1,243 @@
+# Meta Description and Title Tag Optimization
+
+## Overview
+
+Title tags and meta descriptions are the first impression users see in search results. Optimizing these elements directly impacts click-through rate (CTR). Claude generates optimized meta elements by combining best practices with GSC CTR data, then produces A/B variants for testing. This process uses existing WP REST Bridge and GSC tools — no additional APIs needed.
+
+## Title Tag Best Practices
+
+### Rules
+
+| Rule | Standard |
+|------|----------|
+| Maximum length | 60 characters (Google truncates at ~60) |
+| Keyword placement | Primary keyword in the first 3-4 words |
+| Uniqueness | Every page must have a unique title |
+| Brand inclusion | Optional, at end with pipe separator |
+| Keyword repetition | Keyword appears once only |
+| Readability | Must make sense as a standalone phrase |
+
+### Title Tag Formula
+```
+[Primary Keyword] — [Benefit or Differentiator] | [Brand]
+```
+
+### Character Count Optimization
+```
+Ideal:   50-60 characters (full display in all search results)
+OK:      40-50 characters (may look short but fully visible)
+Warning: 60-65 characters (partial truncation on some devices)
+Error:   65+ characters (truncated, meaning lost)
+Too Short: <30 characters (underutilizing title space)
+```
+
+### Examples
+```
+Good (55 chars): "WordPress Speed Optimization — 10 Proven Techniques | Brand"
+Good (48 chars): "How to Speed Up WordPress in 2026 | Brand"
+Bad (72 chars):  "The Complete and Ultimate Guide to WordPress Speed Optimization Tips 2026"
+Bad (18 chars):  "Speed Tips"
+```
+
+## Meta Description Guidelines
+
+### Rules
+
+| Rule | Standard |
+|------|----------|
+| Maximum length | 155-160 characters |
+| Minimum length | 120 characters (shorter looks incomplete) |
+| Keyword inclusion | Primary keyword once, naturally |
+| Call to action | Include an action verb (learn, discover, get, try) |
+| Uniqueness | Every page must have a unique description |
+| Emotional trigger | Include benefit or pain point |
+| Specificity | Use numbers, data, or specific outcomes |
+
+### Meta Description Formula
+```
+[Action verb] [what the reader gets/learns]. [Specific detail or data point]. [CTA].
+```
+
+### Examples
+```
+Good (152 chars):
+"Learn 10 proven WordPress speed optimization techniques that cut load time
+by 50%. Step-by-step guide with benchmarks. Start optimizing today."
+
+Bad (89 chars):
+"This article is about WordPress speed optimization. Read more on our website."
+
+Bad (185 chars):
+"In this comprehensive and detailed guide we will cover everything you need to
+know about optimizing your WordPress website for speed including caching and
+image optimization techniques."
+```
+
+## Using GSC CTR Data for Optimization
+
+### Identifying Low-CTR Pages
+
+#### Step 1: Pull Page Performance Data
+```
+Use gsc_page_performance to get CTR data for all pages.
+Sort by impressions (descending) to focus on high-visibility pages first.
+```
+
+#### Step 2: CTR Benchmarks by Position
+
+| Average Position | Expected CTR | Below Average |
+|-----------------|-------------|---------------|
+| 1 | 25-35% | <20% |
+| 2 | 12-18% | <10% |
+| 3 | 8-12% | <6% |
+| 4-5 | 5-8% | <4% |
+| 6-10 | 2-5% | <2% |
+
+#### Step 3: Flag Optimization Candidates
+Pages with high impressions but below-average CTR are prime candidates:
+```
+Example:
+Page: /wordpress-speed-guide
+Position: 3
+Impressions: 5,000/month
+CTR: 4.2% (expected 8-12% for position 3)
+→ META OPTIMIZATION NEEDED — potential to double clicks
+```
+
+#### Step 4: Analyze Current Meta
+```
+Use get_content to fetch the current title tag and meta description.
+Evaluate against the rules above.
+Identify specific issues (too long, missing keyword, no CTA, etc.).
+```
+
+### CTR Impact Estimation
+```
+Current: Position 3, 5000 impressions, 4.2% CTR = 210 clicks/month
+After optimization to 8% CTR: 5000 × 0.08 = 400 clicks/month
+Potential gain: +190 clicks/month (+90% improvement)
+```
+
+## A/B Variant Generation
+
+### Process
+
+#### Step 1: Generate Two Variants
+Claude generates two meta description variants using different approaches:
+
+**Variant A: Benefit-focused**
+```
+"Cut your WordPress load time by 50% with these 10 proven optimization
+techniques. Includes caching, image compression, and CDN setup. Free guide."
+```
+
+**Variant B: Problem-focused**
+```
+"Slow WordPress site losing visitors? Fix it with 10 tested speed
+techniques. Average improvement: 50% faster. Step-by-step instructions."
+```
+
+#### Step 2: Score Both Variants
+
+| Criteria | Variant A | Variant B |
+|----------|-----------|-----------|
+| Keyword presence | Yes (1st sentence) | Yes (1st sentence) |
+| Length | 148 chars ✓ | 142 chars ✓ |
+| CTA | "Free guide" | "Step-by-step" |
+| Emotional trigger | Benefit (cut load time) | Pain (losing visitors) |
+| Specificity | 50%, 10 techniques | 50% faster |
+| Readability | Clear | Clear |
+
+#### Step 3: Apply and Monitor
+```
+Apply the highest-scoring variant via update_content.
+Set a review date 2-4 weeks out.
+Compare CTR data in GSC after the review period.
+```
+
+### Title Tag A/B Variants
+Same process for title tags:
+```
+Original: "WordPress Speed Guide"
+Variant A: "WordPress Speed Optimization — 10 Techniques That Work"
+Variant B: "How to Speed Up WordPress by 50% (2026 Guide)"
+```
+
+## Rich Snippet Optimization
+
+### Content-Type Specific Guidance
+
+| Content Type | Rich Snippet Opportunity | Meta Optimization |
+|-------------|------------------------|-------------------|
+| How-to articles | HowTo schema | Include "how to" in title, steps count in meta |
+| FAQ pages | FAQPage schema | Include question in title, "answers" in meta |
+| Product pages | Product schema (rating, price) | Include price/rating in meta |
+| Review posts | Review schema (star rating) | Include rating in title/meta |
+| List posts | ItemList schema | Include count in title ("10 Best...") |
+
+### Meta for Featured Snippets
+To optimize for position zero:
+- Structure content to answer specific questions
+- Use the question as an H2 heading
+- Provide a concise answer in the first paragraph (40-60 words)
+- Follow with detailed explanation
+- Include a summary table or list
+
+## Step-by-Step Workflow
+
+### Step 1: Identify Optimization Targets
+```
+Use gsc_page_performance to find pages with:
+- High impressions (>500/month)
+- Below-average CTR for their position
+- Sort by potential impact (impressions × CTR gap)
+```
+
+### Step 2: Fetch Current Meta Elements
+```
+Use get_content for each target page.
+Extract: title tag, meta description, H1, URL slug.
+```
+
+### Step 3: Analyze and Score Current Meta
+Claude evaluates each element against rules above:
+- Title: length, keyword position, clarity, brand
+- Description: length, keyword, CTA, emotional trigger, specificity
+
+### Step 4: Generate Optimized Variants
+For each page, Claude produces:
+- 2 title tag variants
+- 2 meta description variants
+- Score comparison with current version
+- Estimated CTR impact
+
+### Step 5: Apply Changes
+```
+Use update_content to apply the winning variants.
+Document changes for tracking:
+- Page URL
+- Previous title/meta
+- New title/meta
+- Date changed
+- Baseline CTR from GSC
+```
+
+### Step 6: Monitor Results
+After 2-4 weeks:
+```
+Use gsc_page_performance to pull updated CTR data.
+Compare against baseline.
+Iterate if CTR did not improve.
+```
+
+## Best Practices
+
+- Prioritize high-impression pages first (biggest impact from small CTR gains)
+- Never duplicate meta descriptions across pages
+- Avoid meta descriptions that do not match page content (causes bounce)
+- Include the year in title tags for time-sensitive content (guides, reviews)
+- Use active voice and power verbs in meta descriptions
+- Test one change at a time to isolate impact
+- Review and refresh meta descriptions quarterly
+- Consider search intent when crafting meta — informational vs transactional queries need different approaches
+- Do not force keywords into meta descriptions unnaturally — readability trumps keyword presence