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.