includes
1 month ago
packages
1 month ago
LICENSE.md
1 month ago
README.md
1 month ago
abilities-api.php
1 month ago
composer.json
1 month ago
README.md
55 lines
| 1 | # Abilities API |
| 2 | |
| 3 | [_Part of the **AI Building Blocks for WordPress** initiative_ |
| 4 | ](https://make.wordpress.org/ai/2025/07/17/ai-building-blocks) |
| 5 | |
| 6 | [Handbook](https://make.wordpress.org/ai/handbook/projects/abilities-api/) |
| 7 | |
| 8 | ## Overview |
| 9 | |
| 10 | - **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. |
| 11 | - **Scope:** discovery, permissioning, and execution metadata only. Actual business logic stays inside the registering component. |
| 12 | - **Audience:** plugin & theme authors, agency builders, and future AI / automation tools. |
| 13 | |
| 14 | ## Design Goals |
| 15 | |
| 16 | 1. **Discoverability** - every ability can be listed, queried, and inspected. |
| 17 | 2. **Interoperability** - a uniform schema lets unrelated components compose workflows. |
| 18 | 3. **Security‑first** - explicit permissions determine who/what may invoke an ability. |
| 19 | 4. **Gradual adoption** - ships first as a Composer package, migrates smoothly to core. |
| 20 | |
| 21 | ## Documentation |
| 22 | |
| 23 | - **[Developer docs](docs/README.md)**. |
| 24 | - **[Contributing Guidelines](CONTRIBUTING.md)**. |
| 25 | |
| 26 | ## Inspiration |
| 27 | |
| 28 | - **[wp‑feature‑api](https://github.com/automattic/wp-feature-api)** - shared vision of declaring capabilities at the PHP layer. |
| 29 | - Command Palette experiments in Gutenberg. |
| 30 | - Modern AI assistant protocols (MCP, A2A). |
| 31 | |
| 32 | ## Current Status |
| 33 | |
| 34 | | Milestones | State | |
| 35 | | ----------------------------------- | ----------- | |
| 36 | | Placeholder repository | **created** | |
| 37 | | Spec draft | **created** | |
| 38 | | Prototype plugin & Composer package | **created** | |
| 39 | | Community feedback (#core‑ai Slack) | **created** | |
| 40 | | Core proposal | in progress | |
| 41 | | Initial | **created** | |
| 42 | | WordPress 6.9 | in progress | |
| 43 | |
| 44 | ## How to Get Involved |
| 45 | |
| 46 | - **Discuss:** `#core-ai` channel on WordPress Slack. |
| 47 | - **File issues:** suggestions & use‑cases welcome in this repo. |
| 48 | - **Prototype:** experiment with the [feature plugin](https://github.com/WordPress/abilities-api/releases/latest) or the [`wordpress/abilities-api`](https://packagist.org/packages/wordpress/abilities-api) Composer package. |
| 49 | |
| 50 | ## License |
| 51 | |
| 52 | 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](LICENSE.md) for complete license. |
| 53 | |
| 54 | <br/><br/><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p> |
| 55 |