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.