superpowers-sage:ai-setup

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guided installation and validation of the Roots AI stack in Sage/Bedrock projects. This guide helps automate readiness checks, package installation, API key configuration, and MCP handshake verification to enable AI tooling in WordPress-based workflows.

Core Features & Use Cases

  • Automates readiness checks and dependency installation for roots/acorn-ai and wordpress/mcp-adapter.
  • Generates .mcp.json, publishes config, writes API keys to .env, and validates MCP handshake across WordPress environments.
  • Verifies MCP capabilities and enables AI-driven workflows in Sage/Bedrock projects.

Quick Start

Run the readiness probe to detect missing AI components and complete the installation steps.

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 the Roots AI stack in a Sage or Bedrock WordPress project?

Setting up the Roots AI stack in Sage or Bedrock requires installing roots/acorn-ai and wordpress/mcp-adapter packages, generating the .mcp.json config, and managing API keys in your .env file. The setup process automates readiness checks and validates the MCP handshake across WordPress environments.

What prerequisites do I need for WordPress MCP adapter and Acorn AI installation?

Prerequisites for installing the WordPress MCP adapter and Acorn AI include running WordPress 6.9 or higher, alongside compatible PHP, Node, and Lando versions. Satisfying these environment requirements ensures the Roots AI stack passes readiness checks and successfully completes the MCP handshake.

How does the MCP handshake validation work for WordPress AI tooling?

MCP handshake validation verifies communication between your WordPress environment and AI tools by checking the generated .mcp.json configuration and API keys. It confirms MCP capabilities are correctly discovered and the Acorn AI integration is fully operational across your Lando setup.

Can I use Lando to manage API keys for Acorn AI and the WordPress MCP adapter?

Yes, you can use Lando to manage API keys for Acorn AI and the WordPress MCP adapter. The guided setup writes API keys directly to the .env file and publishes configuration to validate the MCP handshake across your local WordPress environments.

Why is my Acorn AI integration not passing the readiness probe in Bedrock?

Your Acorn AI integration might fail the readiness probe in Bedrock due to incompatible WordPress, PHP, Node, or Lando versions. The probe detects missing dependencies and verifies environment prerequisites before allowing MCP adapter installation and handshake validation to proceed.