yoast-wordpress

Repair Yoast readability violations and re-score WordPress posts via REST.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mattei2005/mgs-agent --skill yoast-wordpress
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: yoast-wordpress
Source: https://github.com/mattei2005/mgs-agent/tree/main/profiles/atena-skills/wordpress/yoast-wordpress
Command: npx skills add https://github.com/mattei2005/mgs-agent --skill yoast-wordpress

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Yoast SEO and Readability tasks on WordPress often become slow and error-prone because scoring, score storage (DB + mu-plugin), content repairs, and health monitoring require careful, version-specific handling to avoid score flicker and misleading results.

Core Features & Use Cases

  • Score Architecture Control: Understands and safely works with Yoast’s two-layer scoring model (post meta and wp_yoast_indexable) and the current yoast-rest-meta.php mu-plugin behavior to prevent interfering with Yoast-owned indexables.
  • Readability Repair Workflow: Diagnoses 🔴/🟡 readability violations, rewrites only the violated rules, preserves LazyBlocks exactly, validates strict content constraints, publishes via REST, and re-scores.
  • Site Health Monitor (Cron): Runs a standalone Linux cron monitor that queries wp_yoast_indexable via SSH, applies clear OR-based alert logic across SEO and Readability, snapshots results, and posts conditional Discord alerts.

Quick Start

Load the skill and ask your agent to fix a Yoast Readability red post by preserving LazyBlocks, validating the rewritten content, publishing via REST, and re-running scoring.

Frequently Asked Questions about yoast-wordpress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Yoast SEO readability scoring and repair for WordPress posts?▼

Automating Yoast SEO readability scoring involves diagnosing red and yellow violations, rewriting only the violated rules, publishing via REST, and re-running the server-side scorer to update post meta and wp_yoast_indexable safely.

How does the Yoast SEO two-layer score architecture work when repairing content?▼

The Yoast SEO score architecture stores scores in both post meta and the wp_yoast_indexable table. Safe automation requires understanding this model and the yoast-rest-meta.php mu-plugin behavior to avoid interfering with Yoast-owned indexables.

Can I fix Yoast readability violations without breaking LazyBlocks in WordPress?▼

Fixing Yoast readability violations while preserving LazyBlocks requires a repair workflow that rewrites only the violated rules, validates strict content constraints, and avoids REST hooks that would interfere with Yoast-owned indexables.

What's the best way to monitor Yoast SEO site health across published posts over time?▼

Monitoring Yoast SEO site health over time requires a standalone Linux cron that queries wp_yoast_indexable via SSH, applies OR-based alert logic for SEO and Readability, snapshots results, and posts conditional Discord alerts.

Why does my Yoast SEO score flicker after automated content repairs in WordPress?▼

Yoast SEO score flicker occurs when automated repairs fail to respect the two-layer scoring model. Proper automation validates strict content thresholds, uses the server-side scorer workflow, and avoids REST hooks that disrupt Yoast-owned indexables.

Do I need a mu-plugin to safely automate Yoast SEO scoring and health checks?▼

A mu-plugin like yoast-rest-meta.php is required to safely automate Yoast SEO scoring. It ensures proper score architecture control across post meta and wp_yoast_indexable, preventing automated repairs from interfering with Yoast-owned indexables.