From 48849933e700774ac25aa1d5f5179c582282fdfa Mon Sep 17 00:00:00 2001
From: Molecule AI Documentation Specialist
 <documentation-specialist@agents.moleculesai.app>
Date: Fri, 17 Apr 2026 18:36:42 +0000
Subject: [PATCH] docs(plugins): add molecule-medo as opt-in platform plugin

PR #760 extracted medo.py from builtin_tools (where it was dead code) into
a proper agentskills.io plugin at plugins/molecule-medo/. It is now an
explicit opt-in via local://molecule-medo rather than being silently shipped
in every workspace image.

- Add Platform Opt-in Plugins table with molecule-medo
- Document the three exposed tools: create/update/publish_medo_app
- Show install flow: set MEDO_API_KEY secret, then POST to /plugins
- Show org.yaml example for declarative deployment

Pairs with monorepo PR #760 / closes #741.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 content/docs/plugins.mdx | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/content/docs/plugins.mdx b/content/docs/plugins.mdx
index dee2a35..b001526 100644
--- a/content/docs/plugins.mdx
+++ b/content/docs/plugins.mdx
@@ -190,6 +190,41 @@ Loaded by default from the `plugins/` directory at the repo root.
 | `ecc` | General Claude Code guardrails. |
 | `browser-automation` | Puppeteer/CDP-based web scraping and live canvas screenshots. Opt-in per workspace. |
 
+### Platform Opt-in Plugins
+
+Available in the platform registry (`local://`) but not installed by default.
+Add them per workspace or as org defaults as needed.
+
+| Plugin | Tools | Requires | Purpose |
+|--------|-------|----------|---------|
+| `molecule-medo` | `create_medo_app`, `update_medo_app`, `publish_medo_app` | `MEDO_API_KEY` secret | Baidu MeDo app builder integration — create, update, and publish MeDo mini-apps from within an agent. |
+
+#### Installing molecule-medo
+
+```bash
+# 1. Set your API key
+curl -X POST http://localhost:8080/workspaces/{id}/secrets \
+  -H "Authorization: Bearer {token}" \
+  -H "Content-Type: application/json" \
+  -d '{"key": "MEDO_API_KEY", "value": "your-medo-api-key"}'
+
+# 2. Install the plugin (triggers auto-restart)
+curl -X POST http://localhost:8080/workspaces/{id}/plugins \
+  -H "Authorization: Bearer {token}" \
+  -H "Content-Type: application/json" \
+  -d '{"source": "local://molecule-medo"}'
+```
+
+Or add it to `org.yaml`:
+
+```yaml
+workspaces:
+  - name: App Builder
+    plugins: [molecule-medo]
+    secrets:
+      MEDO_API_KEY: "${MEDO_API_KEY}"
+```
+
 ---
 
 ## Org Template Plugin Resolution