wordpress/abilities-api

AI Abilities for WordPress.

v0.4.0 2025-10-29 05:35 UTC

Requires

• php: ^7.4 | ^8

Requires (Dev)

• automattic/vipwpcs: ^3.0
• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• phpcompatibility/php-compatibility: 10.x-dev as 9.99.99
• phpcompatibility/phpcompatibility-wp: ^2.1
• phpstan/extension-installer: ^1.3
• phpstan/phpstan: ^2.1.22
• phpstan/phpstan-deprecation-rules: ^2.0.3
• phpstan/phpstan-phpunit: ^2.0.3
• phpunit/phpunit: ^8.5|^9.6
• slevomat/coding-standard: ^8.0
• squizlabs/php_codesniffer: ^3.9
• szepeviktor/phpstan-wordpress: ^2.0.2
• wp-coding-standards/wpcs: ^3.1
• wp-phpunit/wp-phpunit: ^6.5
• wpackagist-plugin/plugin-check: ^1.6
• yoast/phpunit-polyfills: ^4.0

GPL-2.0-or-later

• WordPress AI Team

• api
• wordpress
• ai
• abilities
• llm

README

Part of the AI Building Blocks for WordPress initiative

Handbook

Overview

• Purpose: provide a common way for WordPress core, plugins, and themes to describe what they can do ("abilities") in a machine‑readable, human‑friendly form.
• Scope: discovery, permissioning, and execution metadata only. Actual business logic stays inside the registering component.
• Audience: plugin & theme authors, agency builders, and future AI / automation tools.

Design Goals

1. Discoverability - every ability can be listed, queried, and inspected.
2. Interoperability - a uniform schema lets unrelated components compose workflows.
3. Security‑first - explicit permissions determine who/what may invoke an ability.
4. Gradual adoption - ships first as a Composer package, migrates smoothly to core.

Documentation

• Developer docs.
• Contributing Guidelines.

Inspiration

• wp‑feature‑api - shared vision of declaring capabilities at the PHP layer.
• Command Palette experiments in Gutenberg.
• Modern AI assistant protocols (MCP, A2A).

Current Status

Milestones	State
Placeholder repository	created
Spec draft	created
Prototype plugin & Composer package	created
Community feedback (#core‑ai Slack)	created
Core proposal	in progress
Initial	created
WordPress 6.9	in progress

How to Get Involved

• Discuss: #core-ai channel on WordPress Slack.
• File issues: suggestions & use‑cases welcome in this repo.
• Prototype: experiment with the feature plugin or the wordpress/abilities-api Composer package.

License

WordPress is free software, and is released under the terms of the GNU General Public License version 2 or (at your option) any later version. See LICENSE.md for complete license.