media-setup

/media-setup — Platform Configuration Wizard

Configure your media-agent installation. This skill detects available tools, walks you through API key setup for each platform, tests connections, and writes the config files.

Prerequisites

Before starting, read the shared library files:

• Read lib/adapter-discovery.md for how adapters work
• Read lib/manifest-ops.md for manifest format

Step 1: Detect Environment

Check for required and optional tools:

echo "=== media-agent Setup ==="
echo ""

# Required
echo "Checking dependencies..."
which git >/dev/null 2>&1 && echo "  [OK] git" || echo "  [MISSING] git — required"
which python3 >/dev/null 2>&1 && echo "  [OK] python3" || echo "  [MISSING] python3 — required for YAML parsing"
which curl >/dev/null 2>&1 && echo "  [OK] curl" || echo "  [MISSING] curl — required for API calls"

# Optional
echo ""
echo "Optional tools:"
which convert >/dev/null 2>&1 && echo "  [OK] ImageMagick" || echo "  [MISSING] ImageMagick — needed for image resizing (brew install imagemagick)"
which gh >/dev/null 2>&1 && echo "  [OK] GitHub CLI" || echo "  [MISSING] GitHub CLI — optional, for GitHub Pages"

If python3 or curl is missing, stop and tell the user how to install them.

If ImageMagick is missing, warn the user but continue — it's only needed for /media-image.

Step 2: Discover Available Adapters

echo ""
echo "Available platform adapters:"
for adapter in adapters/*/; do
  name=$(basename "$adapter")
  display=$(python3 -c "import yaml; print(yaml.safe_load(open('${adapter}adapter.yaml'))['display_name'])" 2>/dev/null || echo "$name")
  auth_type=$(python3 -c "import yaml; print(yaml.safe_load(open('${adapter}adapter.yaml'))['auth_type'])" 2>/dev/null || echo "unknown")
  echo "  - $display ($auth_type)"
done

Step 3: Configure Each Platform

Use AskUserQuestion to ask which platforms the user wants to configure. Then for each selected platform:

GitHub Pages (auth_type: git_push)