check-compat

Audit WordPress and Gutenberg version compatibility across PHP plugins and block.json schemas.

12|9|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/jnealey88/designsetgo --skill check-compat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-compat
Source: https://github.com/jnealey88/designsetgo/tree/main/.claude/skills/check-compat
Command: npx skills add https://github.com/jnealey88/designsetgo --skill check-compat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool helps developers ensure their WordPress plugins and blocks remain compatible across WordPress and Gutenberg releases, preventing breaking changes after upgrades.

Core Features & Use Cases

  • Audits WordPress version requirements and detects deprecated WordPress functions
  • Validates Gutenberg APIs, apiVersion fields, and block.json schema for all blocks
  • Verifies package usage, theme compatibility, and overall project health
  • Use Case: Before upgrading WordPress or Gutenberg, run this check to surface potential breakages and generate a remediation plan.

Quick Start

Run the compatibility check across the project to surface potential breakages before upgrades.

Frequently Asked Questions about check-compat

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

FAQPage Schema
How do I check WordPress plugin compatibility before upgrading Gutenberg?

Check WordPress plugin compatibility by auditing version requirements, detecting deprecated WordPress functions, and validating block.json schemas to surface potential breakages before upgrading Gutenberg.

What does validating block.json schemas do for Gutenberg block compatibility?

Validating block.json schemas ensures your Gutenberg blocks meet current API standards by verifying apiVersion fields and detecting deprecated wp.* APIs, which prevents upgrade-induced failures in your WordPress plugins and themes.

Can I use a compatibility audit for PHP plugins and theme integrations?

Yes, you can apply a compatibility audit to PHP plugins, Block-based components, and theme integrations to verify package usage, detect deprecated WordPress functions, and ensure overall project health across WordPress and Gutenberg releases.

What is the best way to detect deprecated WordPress APIs in a codebase?

The best way to detect deprecated WordPress APIs is running an automated compatibility check that scans your PHP plugins and block components for outdated wp.* APIs, validating them against current WordPress and Gutenberg version requirements.

Why does my Gutenberg block break after a WordPress upgrade?

Your Gutenberg block breaks after a WordPress upgrade due to deprecated wp.* APIs, incorrect apiVersion fields, or invalid block.json schemas, which a comprehensive compatibility audit identifies to prevent upgrade-induced failures.