Skill: sebastiangansca/yoast-seo-playbook (version 0.1.0)

--- name: yoast-seo-playbook description: Yoast SEO operating playbook for WordPress delivery. Covers Yoast Free vs Yoast Premium capability boundaries, editor workflows, safe optimization QA, and when to use WordPress REST vs wp-admin for SEO tasks. metadata: {"openclaw":{"emoji":"🔎"}} --- # Yoast SEO Playbook (WordPress) Use this skill when planning, reviewing, or executing SEO work on WordPress sites using Yoast. Primary goals: 1. Keep recommendations truthful and implementable in the site's actual Yoast tier. 2. Produce editor-friendly SEO changes (titles, descriptions, schema context, readability). 3. Separate *content SEO operations* from *site design/system operations*. ## Read Order 1. [references/free-vs-premium-matrix.md](references/free-vs-premium-matrix.md) 2. [references/core-workflows.md](references/core-workflows.md) 3. [references/qa-checklist.md](references/qa-checklist.md) 4. [references/sources.md](references/sources.md) ## Operating Rules - Confirm plugin state before proposing feature-dependent actions: - Is Yoast SEO active? - Is Yoast SEO Premium active/licensed? - If Premium status is unknown, default to **Yoast Free-safe** guidance. - Do not claim a feature is available unless confirmed by tier. - Keep one clear H1 per page and logical H2/H3 hierarchy. - Avoid fabricated SEO claims (rank guarantees, fake metrics, invented authority). - For live content CRUD, pair with `wordpress-content-rest-api`. ## Capability Check (always first) For any Yoast task: 1. Confirm Yoast active. 2. Confirm Free-only vs Premium. 3. Select workflow path using the matrix. 4. Mark Premium-only suggestions as optional when tier is uncertain. ## Rilvo Defaults Unless the user states otherwise: - Language: Italian-first (rilvo audience), with clean, direct copy. - Style: practical, non-hype, credible. - Prefer maintainable on-page SEO over hacks. - Keep outputs editor-ready for WordPress/Yoast fields. ## Done Criteria A Yoast SEO task is complete only when: - Tier assumptions are explicit (Free vs Premium). - Title + meta description are unique and intent-aligned. - Heading/content structure is scannable and coherent. - Internal link opportunities are identified (when relevant). - Next action is clear (draft update, review, publish approval).

path: references/core-workflows.md
content: # Core Yoast Workflows

## 1) Page/Post Optimization (default)

Inputs:
- URL or post slug
- Target query / search intent
- Audience + language
- Tier status (Free/Premium/Unknown)

Steps:
1. Verify intent: informational / commercial / transactional / navigational.
2. Draft SEO title (clear + specific; avoid clickbait).
3. Draft meta description (benefit + specificity + natural CTA).
4. Validate heading structure (single H1; logical H2/H3).
5. Improve intro and section clarity for readability.
6. Add/confirm relevant internal links.
7. Mark publish recommendation only after QA checklist pass.

Output format (recommended):
- Proposed SEO title
- Proposed meta description
- H1/H2 structure notes
- Internal linking notes
- Tier assumptions + next action

## 2) Sitewide Hygiene Pass

Use for batches or recurring maintenance:
- Duplicate/weak title patterns
- Missing/weak meta descriptions
- Thin or overlapping pages
- Broken internal links (if surfaced)
- Sitemap/indexability sanity checks

Prioritize:
1. High-value pages (home, service, pricing, core landing pages)
2. Cannibalization risk pages
3. Legacy pages with traffic potential

## 3) Schema/Metadata Validation (Yoast-aware)

- Confirm Yoast-generated metadata exists for URL.
- Verify title/description/canonical/robots are coherent.
- Confirm schema output is plausible for page type.
- If data stale or missing on an existing page:
  - Recommend update in WP admin and/or Yoast optimization routines.

## 4) Premium Branch (only when confirmed)

Use Premium utilities to accelerate, not replace fundamentals:
- Redirect manager for URL change hygiene
- Internal linking suggestions for faster editorial passes
- Multiple keyphrases where content truly covers additional intents

path: references/free-vs-premium-matrix.md
content: # Yoast SEO — Free vs Premium Matrix

Use this to avoid proposing unavailable features.

## Baseline (both Free and Premium)

- SEO title and meta description templates/overrides
- Readability analysis and SEO analysis feedback in editor
- XML sitemaps
- Schema output framework (core graph generation)
- Social metadata basics (OpenGraph/X controls in plugin scope)
- Robots/canonical/meta robots controls in normal Yoast flow
- REST API metadata exposure (`yoast_head`, `yoast_head_json`) for consumption

## Premium-only (treat as optional unless confirmed)

- Redirect manager workflows in Yoast Premium UI
- Internal linking suggestions panel
- Multiple focus keyphrases support
- Orphaned content tooling and related Premium optimization assists
- Premium support/update stream and premium-specific enhancements

## Agent Policy

1. If Premium unknown:
   - Deliver a Free-compatible plan first.
   - Add a separate “If Premium is active” section.
2. If Premium confirmed:
   - You may include Premium workflow accelerators.
3. Never block core SEO work waiting for Premium.

## Practical Split for Delivery

- **Free path:** keyword intent, title/meta quality, heading structure, schema sanity, crawlability basics.
- **Premium path:** speed up execution with linking/redirect/orphan tools, not fundamental strategy changes.

path: references/qa-checklist.md
content: # Yoast SEO QA Checklist (Pre-Publish)

Run this before recommending publish.

## Content & Intent
- [ ] Search intent is clear and matched by content.
- [ ] Primary topic is explicit early in the page.
- [ ] No fabricated claims or unverifiable statements.

## Metadata
- [ ] SEO title is unique, specific, and human-readable.
- [ ] Meta description is unique and aligned with real page content.
- [ ] Canonical behavior is sensible for the URL.
- [ ] Robots directives are intentional (no accidental noindex/nofollow).

## Structure & Readability
- [ ] One H1 only.
- [ ] H2/H3 hierarchy is logical.
- [ ] Paragraphs are scannable and concise.
- [ ] Key sections answer likely user questions.

## Linking
- [ ] At least relevant internal links where useful.
- [ ] Anchor text is descriptive (not generic "click here").

## Tier Integrity
- [ ] Free/Premium assumption is explicit.
- [ ] Premium-only recommendations are marked optional when unconfirmed.

## Delivery Gate
- [ ] Proposed changes are ready for editor paste/update.
- [ ] Next step is explicit: draft update, stakeholder review, or publish approval.

path: references/sources.md
content: # Sources

Validated references used for this skill.

## Yoast Developer Portal

- https://developer.yoast.com/customization/apis/overview/
- https://developer.yoast.com/customization/apis/rest-api/
- https://developer.yoast.com/customization/apis/metadata-api/
- https://developer.yoast.com/features/analysis/overview/
- https://developer.yoast.com/features/seo-tags/titles/functional-specification/
- https://developer.yoast.com/features/seo-tags/descriptions/functional-specification/
- https://developer.yoast.com/features/seo-tags/meta-robots/functional-specification/
- https://developer.yoast.com/features/xml-sitemaps/functional-specification/
- https://developer.yoast.com/features/indexables/functional-specification/
- https://developer.yoast.com/features/schema/plugins/yoast-seo/
- https://developer.yoast.com/features/schema/plugins/yoast-seo-premium/
- https://developer.yoast.com/changelog/yoast-seo/
- https://developer.yoast.com/changelog/yoast-seo-premium/

## Notes

- Yoast marketing pages returned temporary rate limits during scraping windows; rely on developer docs for stable feature references.
- Older Yoast help URLs have moved; prefer current developer portal paths above.

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)