wp-interactivity-api

Diagnose WordPress Interactivity API directive issues across blocks, themes, and plugins.

2|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/joseconti/mcp-skills --skill wp-interactivity-api-joseconti
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wp-interactivity-api
Source: https://github.com/joseconti/mcp-skills/tree/main/wp-interactivity-api
Command: npx skills add https://github.com/joseconti/mcp-skills --skill wp-interactivity-api-joseconti

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps developers identify and fix issues related to WordPress Interactivity API directives, ensuring correct server-side rendering, hydration, and state management across blocks, themes, and plugins.

Core Features & Use Cases

  • Detect and triage data-wp-interactive directives, interactivity stores, and viewScriptModule integration.
  • Provide guidance for server-side rendering, directive processing, and client hydration to improve performance and reliability.
  • Use Case: When a block directive fails to hydrate, follow this skill's procedures to verify stores, contexts, and directive wiring.

Quick Start

Identify the interactive root on the page and enable server-side directives processing to verify correct hydration.

Frequently Asked Questions about wp-interactivity-api

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

FAQPage Schema
Why does my WordPress block fail to hydrate on the frontend?▼

WordPress block hydration fails when interactivity stores or data-wp- directives are incorrectly wired. Diagnosing the interactive root and verifying server-side directive processing ensures proper client hydration across frontend and editor surfaces.

How do I debug WordPress Interactivity API directive issues in my theme?▼

Debug WordPress Interactivity API directives by triaging data-wp-interactive attributes, validating interactivity store initialization, and checking viewScriptModule integration to resolve server-side rendering and directive processing errors.

How does server-side rendering work with the WordPress Interactivity API?▼

Server-side rendering with the WordPress Interactivity API processes data-wp- directives on the server to initialize state before client hydration. Enabling server-side directives processing verifies correct hydration and improves block performance and reliability.

Can I use the WordPress Interactivity API with server-side rendering in plugins?▼

Yes, the WordPress Interactivity API supports server-side rendering in plugins. You can initialize server state, process data-wp- directives, and debug hydration scenarios across blocks and plugins using viewScriptModule integration.

What is the best way to fix viewScriptModule integration errors in interactive blocks?▼

Fix viewScriptModule integration errors by verifying the interactivity store, checking data-wp- directive wiring, and ensuring server-side directive processing is enabled for correct block hydration on the frontend.

Do I need WordPress 6.9+ to use the Interactivity API for debugging directives?▼

Yes, WordPress 6.9+ is required for debugging Interactivity API directives. It provides the necessary server-side rendering, directive processing, and hydration features to correctly initialize server state and triage data-wp- attributes.