superpowers-sage:abilities-authoring

Create callable WordPress Abilities with JSON schemas for the WP MCP Adapter.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-abilities-authoring-hekivo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:abilities-authoring
Source: https://github.com/hekivo/superpowers-sage/tree/main/skills/abilities-authoring
Command: npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-abilities-authoring-hekivo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

It solves the problem of building custom, callable WordPress “Abilities” that an MCP adapter can discover and execute reliably, so you don’t have to handwire AI tools to WordPress internals.

Core Features & Use Cases

  • Ability authoring for WP MCP Adapter: Create PHP Ability classes that expose a JSON input schema and an execute() method that the adapter can call.
  • Discovery and execution workflow: Use discover-abilities and execute-ability so Claude can list and invoke your Ability endpoint.
  • Registration and validation guidance: Wire Abilities into an AbilitiesServiceProvider and troubleshoot schema validation and response serialization issues.

Quick Start

Run lando wp acorn make:ability ListProjects in your project, register the generated Ability in AbilitiesServiceProvider, then restart your AI editor and call discover-abilities to confirm it appears.

Frequently Asked Questions about superpowers-sage:abilities-authoring

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

FAQPage Schema
How do I create callable WordPress Abilities for an MCP adapter?

WordPress Abilities use a noun/verb naming convention for their class names, define inputs using a Draft-07-compatible JSON schema, and return data arrays from their execute method. They are registered via an AbilitiesServiceProvider to enable discover-abilities visibility for AI assistants.

How do I register a custom PHP Ability so Claude can discover it?

You register a custom PHP Ability by adding it to your AbilitiesServiceProvider. After generating the Ability class with lando wp acorn make:ability, wire it into the provider, restart your AI editor, and invoke discover-abilities to confirm the endpoint appears in the adapter list.

Does the WP MCP Adapter require a specific JSON schema version for Abilities?

You need a Roots\Acorn-based WordPress environment with the AcornAi package installed, a local Lando setup for running CLI commands like wp acorn make:ability, and an MCP-compatible AI editor to trigger discover-abilities and execute-ability workflows.

Why is my custom WordPress Ability not showing up in discover-abilities?

If schema validation or response serialization fails, check that your JSON schema is fully Draft-07-compatible and that your execute(array $args): array method strictly returns a valid array. Troubleshoot registration by confirming the Ability is wired correctly in your AbilitiesServiceProvider.