skills.rest
hekivo
hekivoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

superpowers-sage:ai-setup

Install Acorn AI and WordPress MCP adapter for Sage/Bedrock projects.

13|Updated Mar 19, 2026
Search Tags:#configuration#mcp#api keys#wordpress#lando#acorn-ai#ability discovery
One-click install
npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-ai-setup-hekivo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: superpowers-sage:ai-setup
Source: https://github.com/hekivo/superpowers-sage/tree/main/skills/ai-setup
Command: npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-ai-setup-hekivo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of getting a Sage/Bedrock WordPress project working with the Roots AI stack (Acorn AI plus the WordPress MCP adapter) so AI assistants can discover and use WordPress capabilities reliably.

Core Features & Use Cases

  • Guided AI stack readiness and gap detection: Runs a detect-ai-readiness probe and then performs only the missing steps needed for your project to become AI-ready.
  • Automated installation across the correct layers: Installs the Acorn bridge into the theme via Lando and installs the MCP adapter into the Bedrock root using the correct Composer context.
  • MCP configuration generation and verification: Generates or merges the .mcp.json entry and validates the MCP handshake via both WordPress MCP CLI and AI-side ability discovery.
  • Failure-mode guardrails and rollback pointers: Handles common issues like Composer version conflicts, Bedrock installer-path autoload quirks, missing .mcp.json entries, and .env not taking effect, with references for rollback.

Real-world use case: you want Claude Code (or a compatible assistant) to automatically reason about your WordPress site and call MCP tools, but your project is missing one or more packages, config files, or API wiring.

Quick Start

Run the superpowers-sage:ai-setup skill in your project root to install the missing Acorn AI and WordPress MCP adapter pieces, generate .mcp.json, write the required API key line into .env, and validate that MCP can register WordPress abilities.

Frequently Asked Questions about superpowers-sage:ai-setup

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

FAQPage Schema
How do I set up a Sage Bedrock WordPress project for AI assistant integration?▼

To set up a Sage Bedrock WordPress project for AI assistant integration, install roots/acorn-ai and the wordpress/mcp-adapter, generate .mcp.json, write provider API keys to .env, and validate the MCP handshake for ability discovery.

Why does the wp mcp-adapter command fail to register in my Bedrock project?▼

The wp mcp-adapter command fails to register due to Bedrock autoload quirks preventing command registration. Resolve this by running the correct Composer context installs and validating MCP availability via the discover-abilities probe.

What is the MCP configuration process for Acorn AI in WordPress?▼

The MCP configuration process for Acorn AI in WordPress generates or merges the .mcp.json entry and validates the MCP handshake via WordPress MCP CLI and AI-side ability discovery so assistants can reliably call WordPress capabilities.

Do I need Lando to install the Acorn AI bridge into my Sage theme?▼

You need Lando to install the Acorn AI bridge into your Sage theme, while the MCP adapter goes into the Bedrock root using the correct Composer context to ensure proper AI stack readiness across project layers.

What should I do if my .env API key is not taking effect for WordPress MCP?▼

If your .env API key is not taking effect for WordPress MCP, use the failure-mode guardrails to write the correct provider API key line and regenerate the merged MCP configuration to confirm availability via discover-abilities.

Can I use Claude Code with a Sage WordPress site to call MCP tools automatically?▼

You can use Claude Code with a Sage WordPress site to call MCP tools automatically by installing the Acorn AI bridge and MCP adapter, then validating the MCP handshake so the assistant discovers and reasons about WordPress capabilities.

Related Skills

Explore More Software Engineering Skills→
hekivohekivo
13

superpowers-sage:install-plugin

Install WordPress plugins into Roots Bedrock projects via Lando and Composer.

Official
Intermediate
codigodoleocodigodoleo
13

superpowers-sage:abilities-authoring

Define WordPress MCP Abilities with a PHP base class and JSON schema.

Official
Advanced
codigodoleocodigodoleo
13

superpowers-sage:ai-setup

Automate Roots AI stack installation and validation in Sage/Bedrock projects.

Official
Advanced
ostsamostsam

setup-api-key

Guide users to generate, validate, and store a Vapi API key in .env.

Community
Intermediate