@respira/wordpress-mcp-server 8.2.2 → 8.2.3

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to Respira WordPress MCP Server will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.2.3] - 2026-08-04
+
+### Fixed
+
+- **Three real skills were missing from the public catalog and from npx skills / OpenCode installs.** `respira-builder-edits`, `respira-site-audit`, and `respira-woocommerce` had shipped in the bundled skill set for a while but were never published to `respira-press/agent-skills-wordpress`, so anyone installing through `npx skills` or OpenCode never got them, even though the plugin's own installer did. Published all three there now. Also removed `respira-setup`, a stale duplicate of `respira-setup-assistant` that never should have shipped separately. Both catalogs match exactly now: 42 skills, same content, on both sides. Reported by a customer who had `respira-builder-edits` installed and was told it "didn't exist" when checked against the wrong catalog.
+
 ## [8.2.2] - 2026-08-04
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@respira/wordpress-mcp-server",
-  "version": "8.2.2",
+  "version": "8.2.3",
   "mcpName": "io.github.webmyc/respira-wordpress",
   "description": "WordPress MCP server with MCP 2026-07-28 and legacy-client support. 198 tools, 303 with WooCommerce, across 17 page builders and the Site Editor.",
   "main": "dist/index.js",

package/skills/respira-setup/SKILL.md

@@ -1,72 +0,0 @@
----
-name: respira-setup
-description: Use when setting up, checking, or repairing Respira for WordPress MCP in Codex or Claude Code. Covers dashboard install commands, config checks, connection diagnostics, edge-layer write blocks, version mismatches, and safe first WordPress actions.
-metadata:
-  short-description: Set up and diagnose Respira WordPress MCP
-  version: 1.2.0
-  updated_at: 2026-05-17
-  respira_min_version: 7.1.0
----
-
-# Respira Setup
-
-Use this skill when the user wants to install Respira for WordPress in Codex or Claude Code, check whether the MCP server is connected, diagnose errors, or start safe WordPress work through Respira.
-
-## Setup Workflow
-
-1. Send the user to `https://www.respira.press/dashboard/mcp`.
-2. Tell them to select the intended access scope, then click `Install in Codex` or `Install in Claude Code`.
-3. Have them paste the copied command into Terminal.
-4. Ask them to restart the agent so the updated MCP config is loaded.
-5. Verify with `codex mcp list` or `claude mcp list` when shell access is available.
-
-The dashboard installer mints a short-lived token, preserves existing MCP servers in the config, and writes the `respira-wordpress` entry with the selected scope. Prefer it over manual TOML or JSON edits.
-
-For first-time WordPress plugin activation, the v7.1 default is the OAuth flow: the plugin's Setup screen offers `Connect respira.press account` which links the licence to the user's respira.press account so plan changes sync automatically. Manual licence-key paste stays available as a secondary link.
-
-## Diagnostics
-
-When shell access is available, run:
-
-```bash
-npx -y @respira/wordpress-mcp-server@latest --doctor --json
-```
-
-The doctor runs 9 checks in one pass: Node.js version, MCP config, connectivity, plugin version, API negotiation, npm update availability, version compatibility, edge-layer write blocks, and REST endpoint health.
-
-If the MCP tools are already available, call:
-
-- `respira_diagnose_connection` returns a structured report including Cloudflare-edge "Bad Bot" write-block detection (added v7.0.16). Surface the CF allow-list snippet directly when the probe finds the pattern.
-- `respira_get_server_compatibility` returns plugin version, MCP server version, minimum-MCP requirement, and a compatibility verdict.
-- `respira_get_site_context` returns WordPress version, PHP version, active builder, active plugins, and theme.
-
-Use the results to report plugin version, MCP server version, API key status, WordPress version, PHP version, and whether the connection is ready.
-
-## Common Fixes
-
-- No `respira-wordpress` MCP server in `mcp list`: repeat the dashboard `Install in...` flow and restart the agent.
-- `401` or `Unauthorized`: create a fresh API key in WordPress under `Respira > Settings > API Keys`, then rerun the dashboard installer. Older sites may still show `Respira > API Keys` as a top-level menu.
-- `403` or REST API blocked: whitelist `/wp-json/respira/v1/` in the host, WAF, or security plugin. `respira_diagnose_connection` flags this with a structured hint.
-- Cloudflare edge write block: the diagnose tool detects when `GET /wp-json/respira/v1/ping` succeeds but `OPTIONS` is blocked. The fix is a CF rule that allows PUT, PATCH, DELETE, and OPTIONS on the Respira REST namespace.
-- Timeout or fetch failure: confirm the site URL is reachable and that `https://example.com/wp-json/` returns JSON.
-- Version mismatch: update the WordPress plugin to the latest available, then rerun the doctor. v7.1 requires MCP server 6.11.0 or later; the doctor reports the actual requirement.
-- `MCP server self-reports v6.11.4 after upgrade`: this was a stale-constant bug fixed in MCP v6.11.13. Update with `npm install -g @respira/wordpress-mcp-server@latest`.
-
-## Bundled skills
-
-Respira v7.1 ships its skills inside the Claude Code plugin at `respira-press/respira-wordpress`. The skill bundle covers builder edits, this setup flow, site audits, and WooCommerce operations. Two ways to get them:
-
-- **Claude Code plugin install** (recommended): pulls the skills plus the MCP config plus the AGENTS.md briefing in one step.
-- **npm command**: `npx @respira/wordpress-mcp-server install-skills` copies bundled `SKILL.md` files into `~/.claude/skills/` for users who manage their MCP config manually.
-
-## Safe First Actions
-
-After setup succeeds, suggest low-risk checks before any edit:
-
-- List pages or posts to confirm the connection works end to end.
-- Inspect the active theme, plugins, and page builder via `respira_get_site_context` and `respira_get_builder_info`.
-- Create or duplicate a draft before editing production content. `respira_create_page_duplicate` is the canonical entry point.
-- Use `respira_get_page_outline` for a fast structural read before deciding what to edit.
-- Snapshot any page about to take more than one element change.
-
-Never ask the user to paste API keys into chat. Use the dashboard installer for secrets.