Repository: https://github.com/hadealahmad/blocksy-skill

A portable OpenCode skill for configuring WordPress sites that run:

• Blocksy
• Blocksy Child
• Blocksy Companion
• Blocksy Companion Pro

It sets global theme options, the header/footer builder, color palettes, typography, menus, per-page settings, Content Blocks/popups, and extensions.

The bridge is a single-file plugin. It exposes a narrow, authenticated REST API for Blocksy settings. That is what makes full configuration possible when there is no file or database access.

Clone it directly into the global skills directory:

git clone https://github.com/hadealahmad/blocksy-skill.git \
  ~/.config/opencode/skills/blocksy

Or copy this directory to ~/.config/opencode/skills/blocksy/, or keep it as a project skill in .opencode/skills/blocksy/. The skill entry point is SKILL.md.

SITE=/path/to/wordpress
./scripts/wp-local.sh "$SITE" eval-file scripts/inspect.php > current.json
BLOCKSY_INSPECT=export BLOCKSY_INSPECT_PORTABLE=1 \
  ./scripts/wp-local.sh "$SITE" eval-file scripts/inspect.php > backup.json
BLOCKSY_PLAN=examples/example-plan.json \
  ./scripts/wp-local.sh "$SITE" eval-file scripts/apply.php

scripts/wp-local.sh discovers the LocalWP MySQL socket automatically.

1. Upload dist/blocksy-bridge.zip in Plugins → Add New → Upload Plugin.
2. Activate Blocksy Bridge.
3. Settings → Blocksy Bridge → copy the token.
4. Run:

export BLOCKSY_URL="https://example.com"
export BLOCKSY_TOKEN="..."

node scripts/remote.mjs info
node scripts/remote.mjs schema > schema.json
node scripts/remote.mjs export --portable --post-meta > backup.json
node scripts/remote.mjs apply examples/example-plan.json --dry-run
node scripts/remote.mjs apply examples/example-plan.json

Application Passwords are also supported:

export BLOCKSY_USER="admin"
export BLOCKSY_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx"

examples/example-plan.json sets a palette and typography, builds a sticky header and footer, creates a menu, activates a free extension, creates a hook Content Block, and sets a per-page layout.

SKILL.md                  entry point and workflow
references/               adapters, storage, options, builder, content blocks,
                          extensions, menus, verification, plan format
scripts/
  wp-local.sh             LocalWP-aware WP-CLI wrapper
  inspect.php             WP-CLI schema/info/export
  apply.php               WP-CLI plan apply
  remote.mjs              Bridge REST client
bridge/
  blocksy-bridge.php      single-file bridge plugin source
dist/
  blocksy-bridge.zip      uploadable plugin
data/                     versioned option/builder catalogs
examples/
  example-plan.json       one end-to-end example
assets/
  example-plan.png        social/repo preview image
research/                 extraction notes and snapshots used to build this

• The bridge requires an administrator (manage_options).
• Pro gate: when a request needs a Pro-only feature and the site has the free Companion build, stop and ask for Blocksy Companion Pro installation and licence activation. Do not fake or bypass it. See references/pro-gate.md.
• It refuses arbitrary options, arbitrary post types, arbitrary PHP, plugin installation, and user management.
• It never returns Freemius/licence secrets.
• Always export a backup before applying a plan.
• Always run --dry-run first.
• Prefer HTTPS. Rotate the bridge token if it leaks.