install-agentlisted

# Install agent Argument: `$ARGUMENTS` — `<agent-name> [--scope=user|project] [--force] [--method=sparse_clone|raw_url|from_cache] [--no-ephemeral]`. `--no-ephemeral` installs the voltagent as permanent (`ephemeral=false` in the sidecar). Default: voltagents are ephemeral and deleted at SessionEnd unless `use_count` reaches `promote_threshold` (default 5). > **Hard rule:** this skill writes to disk. Confirm with the user before executing any install (unless invoked by `orchestrate` with batch approval). > > **Lazy-load model:** the goal of this skill is to keep `enabledPlugins` minimal so the cumulative agent description budget (15k token warning) stays low. Only agents the user actually invokes get materialized to disk; everything else lives in the FTS5 catalog (zero session-token cost). ## Workflow ### 1. Preflight ```bash set -euo pipefail INDEX_DB=~/.claude/cache/maxvision/index.db test -f "$INDEX_DB" || { printf '%s\n' '{"error":"index missing","suggestion":"Run /maxvision:index-catalog first"}' exit 1 } gh auth status >/dev/null 2>&1 || { printf '%s\n' '{"error":"gh not authenticated","suggestion":"Run gh auth login"}' exit 1 } ``` ### 2. Parse arguments ```bash set -euo pipefail AGENT_NAME="" SCOPE="user" FORCE=0 METHOD="" EPHEMERAL="true" for arg in $ARGUMENTS; do case "$arg" in --scope=*) SCOPE="${arg#--scope=}" ;; --force) FORCE=1 ;; --method=*) METHOD="${arg#--method=}" ;; --no-ephemeral) EPHEMERAL="false" ;; --*) printf '%s\n'