cue-ai 0.3.0 → 0.4.1

package/get.sh

@@ -0,0 +1,159 @@
+#!/usr/bin/env bash
+# cue — one-line installer
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/recodeee/cue/main/get.sh | bash
+#   curl -fsSL https://raw.githubusercontent.com/recodeee/cue/main/get.sh | bash -s -- --yes
+#
+# Environment variables:
+#   CUE_DIR     — where to clone (default: ~/Documents/cue)
+#   CUE_BRANCH  — git branch to clone (default: main)
+
+set -euo pipefail
+
+CUE_DIR="${CUE_DIR:-$HOME/Documents/cue}"
+CUE_BRANCH="${CUE_BRANCH:-main}"
+CUE_REPO="https://github.com/recodeee/cue.git"
+
+# Colors
+if [ -t 2 ] && [ -t 1 ]; then
+  ORANGE='\033[38;5;208m'
+  GREEN='\033[38;5;82m'
+  CYAN='\033[38;5;81m'
+  DIM='\033[2m'
+  BOLD='\033[1m'
+  RED='\033[38;5;196m'
+  YELLOW='\033[38;5;220m'
+  RESET='\033[0m'
+  BG='\033[48;5;235m'
+else
+  ORANGE='' GREEN='' CYAN='' DIM='' BOLD='' RED='' YELLOW='' RESET='' BG=''
+fi
+
+say()  { printf '%s\n' "$*" >&2; }
+ok()   { say "  ${GREEN}✓${RESET} $*"; }
+warn() { say "  ${YELLOW}⚠${RESET} $*"; }
+err()  { say "  ${RED}✗${RESET} $*"; }
+die()  { err "$*"; exit 1; }
+step() { say ""; say "${ORANGE}━━━ $1 ━━━${RESET}"; }
+
+# Banner
+say ""
+say "${ORANGE}   ██████╗██╗   ██╗███████╗${RESET}"
+say "${ORANGE}  ██╔════╝██║   ██║██╔════╝${RESET}"
+say "${ORANGE}  ██║     ██║   ██║█████╗  ${RESET}"
+say "${ORANGE}  ██║     ██║   ██║██╔══╝  ${RESET}"
+say "${ORANGE}  ╚██████╗╚██████╔╝███████╗${RESET}"
+say "${ORANGE}   ╚═════╝ ╚═════╝ ╚══════╝${RESET}"
+say ""
+say "  ${BOLD}Agent Profile Manager${RESET} for Claude Code & Codex"
+say "  ${DIM}https://github.com/recodeee/cue${RESET}"
+say "  ${DIM}npm: cue-ai${RESET}"
+say ""
+
+# Step 1: Prerequisites
+step "Step 1/4 — checking prerequisites"
+
+if ! command -v git >/dev/null 2>&1; then
+  die "git is required. Install it first:
+     macOS:  xcode-select --install
+     Ubuntu: sudo apt install git
+     Fedora: sudo dnf install git"
+fi
+ok "git $(git --version | cut -d' ' -f3)"
+
+if ! command -v bun >/dev/null 2>&1; then
+  say "  ${DIM}Installing bun...${RESET}"
+  curl -fsSL https://bun.sh/install | bash >/dev/null 2>&1
+  export PATH="$HOME/.bun/bin:$PATH"
+  if ! command -v bun >/dev/null 2>&1; then
+    die "bun install failed. Install manually: https://bun.sh"
+  fi
+  ok "bun installed ($(bun --version))"
+else
+  ok "bun $(bun --version)"
+fi
+
+# Step 2: Clone/update repo
+step "Step 2/4 — installing cue"
+
+if [ -d "$CUE_DIR/.git" ]; then
+  say "  ${DIM}Updating existing install at ${CUE_DIR}...${RESET}"
+  cd "$CUE_DIR"
+  git pull --ff-only origin "$CUE_BRANCH" 2>/dev/null || true
+  ok "repo updated"
+else
+  say "  ${DIM}Cloning to ${CUE_DIR}...${RESET}"
+  git clone --depth 1 --branch "$CUE_BRANCH" "$CUE_REPO" "$CUE_DIR" 2>/dev/null
+  ok "cloned"
+fi
+
+# Step 3: Install dependencies
+step "Step 3/4 — installing dependencies"
+
+cd "$CUE_DIR"
+bun install --frozen-lockfile 2>/dev/null || bun install 2>/dev/null
+ok "dependencies installed"
+
+# Verify binary
+if "$CUE_DIR/bin/cue" --version >/dev/null 2>&1; then
+  ok "cue $($CUE_DIR/bin/cue --version) works"
+else
+  die "cue binary check failed"
+fi
+
+# Step 4: Set up PATH + shims
+step "Step 4/4 — setting up PATH"
+
+SHIM_DIR="$HOME/.local/bin"
+mkdir -p "$SHIM_DIR"
+
+# Symlink cue
+if [ -L "$SHIM_DIR/cue" ] || [ -f "$SHIM_DIR/cue" ]; then
+  rm -f "$SHIM_DIR/cue"
+fi
+ln -s "$CUE_DIR/bin/cue" "$SHIM_DIR/cue"
+ok "cue → $SHIM_DIR/cue"
+
+# Claude shim
+cat > "$SHIM_DIR/claude" << 'SHIM'
+#!/usr/bin/env bash
+exec "$(dirname "$(readlink -f "$0")")/cue" launch claude "$@"
+SHIM
+chmod +x "$SHIM_DIR/claude"
+ok "claude shim → $SHIM_DIR/claude"
+
+# Check PATH
+if echo "$PATH" | tr ':' '\n' | grep -qx "$SHIM_DIR"; then
+  ok "$SHIM_DIR is on PATH"
+else
+  warn "$SHIM_DIR is NOT on PATH"
+  say "    ${DIM}Add to your shell rc:${RESET}"
+  say "    ${CYAN}export PATH=\"\$HOME/.local/bin:\$PATH\"${RESET}"
+fi
+
+# Done!
+say ""
+say "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+say "${GREEN}  ✓ cue installed successfully!${RESET}"
+say "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+say ""
+say "  ${BOLD}Get started:${RESET}"
+say ""
+say "    ${CYAN}cd ~/your-project${RESET}"
+say "    ${CYAN}cue init${RESET}              ${DIM}# set up a profile${RESET}"
+say "    ${CYAN}claude${RESET}                ${DIM}# launch with profile${RESET}"
+say ""
+say "  ${BOLD}Useful commands:${RESET}"
+say ""
+say "    ${CYAN}cue list${RESET}              ${DIM}# show profiles${RESET}"
+say "    ${CYAN}cue optimizer${RESET}         ${DIM}# visual dashboard${RESET}"
+say "    ${CYAN}cue marketplace search \"X\"${RESET}  ${DIM}# find MCPs/skills${RESET}"
+say "    ${CYAN}cue --help${RESET}            ${DIM}# all commands${RESET}"
+say ""
+say "  ${BOLD}Shell hook${RESET} (auto-switch profile on cd):"
+say ""
+say "    ${CYAN}echo 'eval \"\$(cue shell hook)\"' >> ~/.bashrc${RESET}"
+say ""
+say "  ${DIM}Docs: $CUE_DIR/README.md${RESET}"
+say ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cue-ai",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "cue — Agent Profile Manager for Claude Code & Codex. Pick a profile, launch with the right skills, MCPs, and plugins.",
   "type": "module",
   "bin": {
@@ -39,10 +39,21 @@
   "files": [
     "bin/",
     "src/",
-    "profiles/",
-    "resources/",
+    "profiles/*/profile.yaml",
+    "profiles/*/logo.png",
+    "profiles/*/README.md",
+    "profiles/_types.ts",
+    "profiles/schema.json",
+    "profiles/SCHEMA.md",
+    "profiles/README.md",
+    "resources/skills/skills/",
+    "resources/skills/README.md",
+    "resources/mcps/configs/",
+    "resources/mcps/README.md",
+    "resources/icons/",
     "plugins/",
     "install.sh",
+    "get.sh",
     "README.md",
     "LICENSE"
   ],

package/profiles/_types.ts

@@ -5,7 +5,7 @@
  *   import type { Profile, NpxSkillRef, MCPRef, SkillRef } from "../../profiles/_types";
  */
 
-export type AgentKind = "claude-code" | "codex";
+export type AgentKind = "claude-code" | "codex" | "cursor" | "cline" | "windsurf" | "gemini" | "copilot" | "roo" | "amp" | "aider";
 
 export interface AgentScoped {
   agents?: AgentKind[];

package/profiles/core/profile.yaml

@@ -9,7 +9,10 @@ skills:
     - meta/analyze
     - meta/cue-usage
     - meta/builtin-manager
+    - meta/kiro-powers
     - caveman/caveman
     - caveman/caveman-commit
+mcps:
+  - cue-tty-watch    # Claude's eyes inside X displays / tmux panes (screenshot, capture-pane, send-keys)
 plugins:
   - claude-mem@thedotmack

package/profiles/full/profile.yaml

@@ -6,7 +6,6 @@ skills:
   local:
     - "*/*"
 mcps:
-  - claude-mem
   - Higgsfield
   - colony
   - coolify
@@ -15,7 +14,6 @@ mcps:
   - hostinger-api
   - letsfg
   - marva-blog
-  - medusadocs
   - obsidian-vault
   - polymarket-live
   - recodee

package/profiles/{readme-writer-svg → readme-writer}/profile.yaml

@@ -1,13 +1,14 @@
-name: readme-writer-svg
+name: readme-writer
 icon: "🎨"
 description: "Beautiful README design with SVG diagrams — architecture flows, terminal mockups, and editorial visuals"
 inherits: core
 skills:
   local:
     - design/readme-svg-design
+    - design/headless-gif-demo
   npx:
     - repo: yizhiyanhua-ai/fireworks-tech-graph
       skills: [fireworks-tech-graph]
     - repo: cathrynlavery/diagram-design
       skills: [diagram-design]
-mcps: []
+mcps: []   # cue-tty-watch comes from core via inheritance

package/profiles/threejs/profile.yaml

@@ -0,0 +1,19 @@
+name: threejs
+icon: "🎲"
+description: "Three.js 3D development — geometry, materials, shaders, animation, postprocessing, and interaction"
+inherits: core
+skills:
+  npx:
+    - repo: CloudAI-X/threejs-skills
+      skills:
+        - threejs-fundamentals
+        - threejs-geometry
+        - threejs-materials
+        - threejs-lighting
+        - threejs-textures
+        - threejs-animation
+        - threejs-loaders
+        - threejs-shaders
+        - threejs-postprocessing
+        - threejs-interaction
+mcps: []

package/resources/mcps/configs/claude.sanitized.json

@@ -10,6 +10,9 @@
       "env": {
         "KROSCHUORDER_API_URL": "<redacted>"
       }
+    },
+    "cue-tty-watch": {
+      "command": "/home/deadpool/Documents/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
     }
   },
   "source": "claude",

package/resources/mcps/configs/claude_runtime.sanitized.json

@@ -110,6 +110,9 @@
         "~/Documents/soul/mcps/mcps/soul-skills/server.py"
       ],
       "command": "~/.local/bin/uv"
+    },
+    "cue-tty-watch": {
+      "command": "/home/deadpool/Documents/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
     }
   },
   "source": "claude_runtime",

package/resources/mcps/configs/codex.sanitized.json

@@ -79,6 +79,9 @@
       ],
       "command": "~/.local/bin/uv",
       "enabled": false
+    },
+    "cue-tty-watch": {
+      "command": "/home/deadpool/Documents/cue/resources/mcps/cue-tty-watch/bin/cue-tty-watch"
     }
   },
   "source": "codex",

package/resources/skills/skills/design/headless-gif-demo/SKILL.md

@@ -0,0 +1,168 @@
+---
+description: "When user asks to record a high-quality CLI demo GIF that needs Kitty graphics protocol (real PNG icons inline) — use this headless Xvfb + Kitty + tmux + ffmpeg pipeline instead of vhs/asciinema which don't speak the Kitty protocol"
+requires_mcps: []
+allowed-tools: Bash(Xvfb:*), Bash(kitty:*), Bash(tmux:*), Bash(xdotool:*), Bash(ffmpeg:*), Bash(/usr/bin/ffmpeg:*), Read(*), Write(*)
+---
+
+# Headless GIF demos with Kitty + tmux + Xvfb + ffmpeg
+
+When you need a demo GIF of a CLI tool that uses **Kitty graphics protocol** (e.g. cue's brand-logo PNGs in `cue optimizer`), `vhs` and `asciinema` won't work — they render in `ttyd` which doesn't speak the protocol. Logos show as garbled placeholder boxes or fall back to emoji.
+
+This skill captures the working pipeline: spin up a virtual X display, run real Kitty inside it (no monitor needed), drive the demo with `tmux send-keys`, and screen-record with `ffmpeg x11grab`.
+
+## When to use
+
+- ✅ Demo of a CLI that uses Kitty graphics (inline images, brand logos, plots)
+- ✅ Demo of a TUI that depends on truecolor + Unicode + Nerd Font glyphs
+- ✅ Demo that must show interactive prompts (pickers, confirmations)
+- ❌ Plain shell-output demos → use `vhs` (simpler, no X needed)
+- ❌ Real session recordings → use `asciinema` (escape-sequence based)
+
+## Required tools
+
+| Tool | Install (apt) | Install (nix) |
+|---|---|---|
+| `Xvfb` | `sudo apt install xvfb` | `nix profile install nixpkgs#xorg.xorgserver` |
+| `xdotool` | `sudo apt install xdotool` | `nix profile install nixpkgs#xdotool` |
+| `ffmpeg` with `x11grab` | `sudo apt install ffmpeg` (**not** nix-pure ffmpeg — that one lacks x11grab) | `nix profile install nixpkgs#ffmpeg-full` |
+| `kitty` | already on your box | — |
+| `tmux` | already on your box | — |
+
+**Gotcha:** verify ffmpeg has x11grab with `ffmpeg -devices | grep x11`. nix's stock `ffmpeg` doesn't ship it — use `/usr/bin/ffmpeg` (apt) or `ffmpeg-full` (nix).
+
+## The pipeline
+
+```
+Xvfb :99 → kitty (--start-as=fullscreen, attached to tmux session)
+              ↓
+        tmux send-keys (drives demo non-interactively)
+              ↓
+        ffmpeg x11grab :99 (records the virtual display to mp4)
+              ↓
+        ffmpeg palettegen + paletteuse (2-pass → sharp gif)
+```
+
+## Key parameters that matter
+
+1. **Strip cue/claude env vars before launching the inner shell** — `unset CUE_LAUNCHING CLAUDE_CONFIG_DIR CLAUDECODE CLAUDE_CODE_SESSION_ID CLAUDE_EFFORT AI_AGENT CODEX_HOME`. Otherwise the shim's recursion guard fires the moment you type `claude`.
+
+2. **PATH ordering inside the inner shell.** `~/.local/bin` (shim) must come first so `claude` resolves to the shim; the real binary (e.g. `~/.nvm/versions/node/<v>/bin`) must come next so `cue launch` can `exec` it. nvm-installed binaries are NOT inherited by ttyd's bash — set PATH explicitly.
+
+3. **tmux passthrough for Kitty graphics.** Inner tmux config needs:
+   ```
+   set -g allow-passthrough on
+   set -g default-terminal "xterm-kitty"
+   set -as terminal-features ",xterm-kitty:RGB"
+   ```
+   Plus `export TERM=xterm-kitty` and `export CUE_KITTY=1` inside the tmux pane so cue uses the kitty path through tmux.
+
+4. **Kitty must fill the Xvfb display.** Use `--start-as=fullscreen` (no WM needed). If that fails on a minimal Xvfb, `xdotool search --class <cls> windowsize <W> <H>` as a fallback. Without this, kitty opens at 80×24 in a corner and ffmpeg captures mostly blank pixels — the GIF comes out ~20 KB instead of ~1 MB.
+
+5. **Kitty option values are raw — never `px`.** `--override initial_window_width=1500`, not `1500px`. The parser rejects the suffix and kitty silently fails to start; xdotool then finds no window and ffmpeg records the empty Xvfb root.
+
+6. **Verify before recording.** After kitty launches, grab a single frame:
+   ```bash
+   DISPLAY=:99 xwd -root | convert xwd:- /tmp/preflight.png
+   ```
+   If `/tmp/preflight.png` is solid color → kitty isn't on Xvfb. If it shows your terminal → start ffmpeg.
+
+7. **Pickers ask twice.** After Enter selects a profile, cue's picker shows a second "Pin to this directory? Yes/No" prompt. Need a second Enter to confirm or your demo hangs.
+
+## Skeleton script
+
+See [`scripts/record-demo-kitty.sh`](../../../../../scripts/record-demo-kitty.sh) for the complete working version. Structure:
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+DISPLAY_NUM=:99
+WIDTH=1500; HEIGHT=900
+FFMPEG=/usr/bin/ffmpeg            # the apt build — has x11grab
+
+# 1. virtual display
+Xvfb $DISPLAY_NUM -screen 0 ${WIDTH}x${HEIGHT}x24 &
+XVFB_PID=$!
+trap "kill $XVFB_PID 2>/dev/null" EXIT
+sleep 1.5
+
+# 2. tmux config + detached session
+cat > /tmp/tmux.conf <<'EOF'
+set -g allow-passthrough on
+set -g default-terminal "xterm-kitty"
+set -g status off
+EOF
+DISPLAY=$DISPLAY_NUM tmux -L demo -f /tmp/tmux.conf \
+  new-session -d -s d -x $((WIDTH/10)) -y $((HEIGHT/22)) \
+  "cd /tmp/cue-demo && bash --noprofile --norc -i"
+
+SEND() { tmux -L demo send-keys -t d "$@"; }
+SEND 'unset CUE_LAUNCHING CLAUDE_CONFIG_DIR CLAUDECODE' Enter
+SEND 'export PATH="$HOME/.local/bin:$HOME/.nvm/versions/node/v22.22.0/bin:$PATH"' Enter
+SEND 'export TERM=xterm-kitty CUE_KITTY=1' Enter
+SEND 'clear' Enter
+sleep 0.5
+
+# 3. real kitty on the virtual display
+DISPLAY=$DISPLAY_NUM kitty \
+  --class cue-demo --start-as=fullscreen \
+  --override font_family="JetBrainsMono Nerd Font" \
+  --override font_size=14 \
+  --override initial_window_width=$WIDTH \
+  --override initial_window_height=$HEIGHT \
+  -- tmux -L demo attach -t d &
+sleep 2.5
+
+# 4. preflight
+DISPLAY=$DISPLAY_NUM xwd -root | convert xwd:- /tmp/preflight.png
+echo "preflight: $(identify -format '%[mean]' /tmp/preflight.png) mean intensity"
+
+# 5. record
+$FFMPEG -y -f x11grab -video_size ${WIDTH}x${HEIGHT} -framerate 15 \
+  -i $DISPLAY_NUM -t 40 -c:v libx264 -preset ultrafast -pix_fmt yuv420p \
+  /tmp/raw.mp4 &
+FFMPEG_PID=$!
+sleep 1
+
+# 6. drive the demo
+SEND 'cue optimizer readme-writer' Enter
+sleep 7
+SEND 'claude' Enter
+sleep 3
+for i in $(seq 1 14); do SEND Down; sleep 0.08; done
+sleep 0.7
+SEND Enter           # selects profile
+sleep 1.6
+SEND Enter           # answers "Pin to this directory? Yes" prompt
+sleep 7
+
+wait $FFMPEG_PID
+
+# 7. 2-pass mp4 → gif (sharp colors)
+$FFMPEG -y -i /tmp/raw.mp4 \
+  -vf "fps=12,scale=1200:-1:flags=lanczos,palettegen=stats_mode=diff" \
+  /tmp/palette.png
+$FFMPEG -y -i /tmp/raw.mp4 -i /tmp/palette.png \
+  -lavfi "fps=12,scale=1200:-1:flags=lanczos [x]; [x][1:v] paletteuse=dither=bayer:bayer_scale=4" \
+  docs/assets/demo.gif
+```
+
+## Sanity check the output
+
+Healthy capture:
+- raw mp4 ≥ 500 KB for ~30 s recording
+- output gif 400 KB – 2 MB
+- `ffmpeg -i raw.mp4` reports bitrate in the hundreds of kbps, not single digits
+
+Pathological capture (means kitty didn't render to Xvfb):
+- raw mp4 < 50 KB (4 kbps bitrate is the smoking gun)
+- gif comes out 10–20 KB
+- single extracted frame compresses to a few KB (solid color)
+
+## Workflow
+
+1. Verify tools: `which Xvfb xdotool kitty tmux && /usr/bin/ffmpeg -devices | grep x11`
+2. Copy the skeleton from [`scripts/record-demo-kitty.sh`](../../../../../scripts/record-demo-kitty.sh) — adapt the demo commands
+3. Test-run; check the preflight screenshot is non-empty
+4. Iterate on timing — pickers and Claude Code splash both need 2–3 s headroom
+5. Commit both the script and the resulting GIF — re-running gives byte-identical output for a fixed tape

package/resources/skills/skills/meta/kiro-powers/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: kiro-powers
+description: >-
+  When user says "import kiro power", "add power to profile", or "use X power" —
+  import a Kiro Power (POWER.md + MCP config) from GitHub into a cue profile as
+  a skill + MCP entry. Bridges the Kiro Powers ecosystem into cue.
+tags: [meta, cue, kiro, powers, interop]
+category: meta
+version: 1.0.0
+requires_mcps: []
+allowed-tools: Bash(curl:*), Bash(gh:*), Bash(git:*), Read(*), Write(*)
+---
+
+# Kiro Powers → cue Profile Importer
+
+Import Kiro Powers (from kiro.dev or GitHub) into cue profiles. A Kiro Power is:
+- `POWER.md` — steering file with activation keywords + workflow instructions
+- MCP server configuration
+- Optional hooks and slash commands
+
+cue can use these directly by converting them to skill + MCP entries.
+
+## When to activate
+
+- User says "import kiro power X" or "add the Stripe power"
+- User says "use kiro powers" or "convert power to skill"
+- User mentions a known Kiro power partner (Supabase, Stripe, Neon, Netlify, Figma, Postman, Datadog)
+
+## Power → cue Mapping
+
+| Kiro Power component | cue equivalent |
+|---------------------|----------------|
+| `POWER.md` | Skill `SKILL.md` (rename + adapt frontmatter) |
+| MCP server config | Entry in `resources/mcps/configs/` |
+| Activation keywords | Skill `description` field (triggers matching) |
+| Hooks | Skill body instructions |
+| Slash commands | Skill body sections |
+
+## Workflow
+
+### 1. Find the Power
+
+```bash
+# From GitHub URL
+git clone --depth 1 <power-repo-url> /tmp/power-import
+
+# Or from known partners
+# Supabase: github.com/supabase/kiro-power
+# Stripe: github.com/stripe/kiro-power
+# Neon: github.com/neondatabase/kiro-power
+```
+
+Check for `POWER.md` at the root or in a `power/` subdirectory.
+
+### 2. Parse the Power
+
+Read `POWER.md` and extract:
+
+```
+---
+name: supabase
+keywords: [database, postgres, supabase, rls, edge-functions]
+mcp:
+  command: npx
+  args: ["-y", "@supabase/mcp-server"]
+  env:
+    SUPABASE_ACCESS_TOKEN: "${SUPABASE_ACCESS_TOKEN}"
+---
+
+# Supabase Power
+
+## Onboarding
+...
+
+## Workflows
+...
+```
+
+### 3. Convert to cue skill
+
+Create `resources/skills/skills/kiro/<power-name>/SKILL.md`:
+
+```markdown
+---
+name: <power-name>
+description: "<keywords joined as natural language trigger>"
+tags: [kiro-power, <power-name>]
+category: kiro
+version: 1.0.0
+requires_mcps: [<power-name>]
+allowed-tools: mcp__<power-name>__*
+---
+
+<POWER.md body content here>
+```
+
+### 4. Add MCP config
+
+Add to `resources/mcps/configs/claude_runtime.sanitized.json`:
+
+```json
+{
+  "servers": {
+    "<power-name>": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server"],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+### 5. Add to profile
+
+```yaml
+# In profiles/<target>/profile.yaml
+skills:
+  local:
+    - kiro/<power-name>
+mcps:
+  - <power-name>
+```
+
+### 6. Verify
+
+```bash
+cue validate <profile>
+cue doctor --profile <profile>
+```
+
+## Known Kiro Power Partners
+
+| Power | MCP Package | Keywords |
+|-------|------------|----------|
+| Supabase | `@supabase/mcp-server` | database, postgres, supabase, rls |
+| Stripe | `@stripe/mcp` | payment, checkout, billing, stripe |
+| Neon | `@neondatabase/mcp-server` | postgres, neon, serverless-db |
+| Netlify | `@netlify/mcp-server` | deploy, netlify, hosting |
+| Figma | `@figma/mcp-server` | design, figma, ui, components |
+| Postman | `@postman/mcp-server` | api, testing, postman, collections |
+| Datadog | `@datadog/mcp-server` | monitoring, datadog, observability |
+
+## Rules
+
+- Always preserve the original POWER.md content — it contains the expertise
+- Map `keywords` to the skill `description` for cue's matching
+- Add `requires_mcps` so cue warns if the MCP isn't configured
+- Keep the MCP env vars as `${PLACEHOLDER}` — user fills them in
+- If the power has multiple steering files, create one skill per workflow OR bundle them as references/
+- Confirm with user before writing to the MCP registry