Abilities API

Introduction

The power of WordPress, derived from its thousands of functions within core, plugins, and themes, is often obscured by its reliance on developer-centric code. The Abilities API (GitHub) addresses this by establishing a shared language, enabling all WordPress components to express their capabilities in a unified manner, comprehensible to both humans and machines.

This API creates a centralized registry where all functionalities can be formally registered with well-defined schemas, comprehensive descriptions, and explicit permissions. By adopting this common language, plugins and themes will empower AI-driven solutions to seamlessly discover, interpret, utilize, and coordinate capabilities throughout the entire WordPress ecosystem.

The Challenge We’re Solving

A typical WordPress site might have dozens of plugins, each adding unique functionality. But there’s no standardized way for these components to express their capabilities. An AI assistant has no systematic way to discover that your backup plugin can create snapshots, your SEO plugin can analyze content, or your e-commerce solution can generate reports. This fragmentation limits what we can build.

The Abilities API establishes a common pattern the entire ecosystem can adopt. It may look something like this:

// Any plugin can register its abilities with the `init` hook.
wp_register_ability( 'my-seo-plugin/analyze-content-seo', [
    'label'       => __( 'Analyze Content SEO', 'my-seo-plugin' ),
    'description' => __( 'Analyzes post content for SEO improvements.', 
'my-seo-plugin' ),
    'thinking_message' => __('Reviewing your content now!'),
    'success_message' => __('Content reviewed successfully.'),
    'execute_callback'    => [ 'MySEOPlugin', 'analyze_content' ],
    'input_schema'  => [
        'type' => 'object',
        'properties' => [
            'post_id' => [ 'type' => 'integer', 'description' => __( 'The post identifier.', 'my-seo-plugin' ), 'required' => true ],
        ],
        'additional_properties' => false,
    ],
    'output_schema' => ]
        'type' => 'number',
        'description' => __( 'The score for the content in percentage.', 'my-seo-plugin' ),
        'required' => true,
    ],
    'permission_callback'  => 'edit_posts',
] );

When the ecosystem adopts this pattern, WordPress transforms from isolated functionalities into an interconnected system where capabilities can be discovered, composed, and automated. Abilities can be used for AI, but also for things like the Command Palette, Workflows tools, and integrating with UI like toolbars, menus, etc.

When used for AI, developers can create impressive systems like automation tools and AI agents (leveraging other building blocks, like the PHP AI Client for a LLM-based orchestrator).

Enabling AI Integration

The Abilities API also allows AI systems such as Claude, ChatGPT, Gemini, and other assistants to discover WordPress capabilities through adapters like the MCP Adapter. Once registered, flagged abilities become accessible to any AI system that supports the relevant protocols.

The API manages registration and permissions, while protocol Adapters translate these into formats external AI systems understand. This establishes a robust connection between WordPress functionality and AI assistants, with the first-party API serving as the definitive source for exposed logic.

Developer Adoption and Distribution

While available as a plugin for experimentation, the Abilities API is designed as a Composer package that developers can include in their plugins today. This serves as the official adoption path before potential WordPress core inclusion. Developers can require the package now, ship plugins with standardized capability declarations, and seamlessly transition when the Abilities API becomes part of WordPress itself.

Getting Involved

The Abilities API needs input from across the WordPress ecosystem. Whether you’re a plugin developer exposing functionality, a theme author registering visual capabilities, or building AI solutions for WordPress, your perspective is crucial.

Join the discussion in #core-ai on Slack, explore the early implementation, or share your vision for how WordPress Abilties should work in our future with AI.

#ai-building-blocks