# Apex Profile

> Scope the tonone agent roster for this project — install a curated subset of agents instead of the full 100-agent bundle. Use when "cut down the agent list", "profile for this project", "too many agents", "only need the engineering core", or after apex-stats shows a roster that's mostly unused.

- Skill: `tonone-ai/apex-profile-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add tonone-ai/apex-profile-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tonone-ai/apex-profile-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: tonone-ai (https://skillmd.com/u/tonone-ai)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/tonone-ai/apex-profile-2

---


<!-- GENERATED from SKILL.md.tmpl by scripts/gen-skill-docs.py — edit the .tmpl or skills/_sections/*.md, not this file -->

# Apex Profile

You are Apex — the engineering lead. Scope the installed agent roster to what this project actually uses.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

## Why this exists

Each tonone agent is registered as its own plugin (`<agent>@tonone-ai`) in `.claude-plugin/marketplace.json`, self-contained with its own skills, hooks, and scripts. Installing the monolithic `tonone@tonone-ai` plugin registers all ~100 agents in every session regardless of project. Toggling individual agent plugins on/off via `enabledPlugins` in `.claude/settings.json` gives per-project scoping without any new plugin architecture — this skill automates writing that config correctly.

**Recommended default after install.** The full bundle lists ~37,500 tokens of skill/agent descriptions at every session start; the `web-app` preset lists ~3,300 (estimated chars/4, measured with `scripts/measure-context.py`).

## Steps

1. **Read current state.** Check for an existing `.claude/settings.json` and `.claude/settings.local.json` in the project root. If either has an `enabledPlugins` block, show what's currently enabled (in particular, whether `tonone@tonone-ai` — the full bundle — is on).

2. **Ask how to pick the roster** (AskUserQuestion, single-select):
   - **Detected shape** — let the project pick. Run the shared detector and offer its `agents` array as the roster. `CLAUDE_PLUGIN_ROOT` is not exported into the Bash tool's environment, so locate the detector first — plugin root if set, then the repository checkout you are standing in, then the installed plugin cache:

     ```bash
     shape=""
     for c in "${CLAUDE_PLUGIN_ROOT:-/nonexistent}/lib/signals/project-shape.js" \
              "${CLAUDE_PLUGIN_ROOT:-/nonexistent}/../../lib/signals/project-shape.js" \
              "$PWD/lib/signals/project-shape.js"; do
       [ -f "$c" ] && shape="$c" && break
     done
     if [ -z "$shape" ]; then
       found=$(find "$HOME/.claude/plugins/cache" -maxdepth 6 \
         -path "*/lib/signals/project-shape.js" 2>/dev/null | head -1)
       [ -n "$found" ] && shape="$found"
     fi
     if [ -n "$shape" ]; then
       node "$shape" --pretty --cwd "$PWD"
     else
       echo '{"ok":false,"error":"detector not on disk","source":"default"}'
     fi
     ```

     Written this way the block exits 0 and prints one JSON object on every path, under bash, zsh and sh alike (`ok`, `label`, `agents`, `evidence`, `source`, `alternate`). Show `label` and `evidence` so the user can see what it read. A `source` of `default` means nothing matched — say so rather than presenting the starter roster as a match. An `ok` of `false` means the detector is not installed here at all (a single-agent install ships no `lib/`); fall through to **Preset** rather than presenting its placeholder roster.

   - **Preset** — pick from a named project-type roster (below)
   - **Custom list** — user names the agents directly
   - **From apex-stats** — run `/apex-stats` first, then default the roster to every agent with at least one spawn in the lookback window
   - **Full roster (undo)** — revert to installing all agents

   Presets (curated, extend as needed — cite these verbatim, don't invent new ones without asking):

   | Preset           | Agents                                             |
   | ---------------- | -------------------------------------------------- |
   | `web-app`        | apex, spine, flux, prism, proof, warden, crest     |
   | `mobile-app`     | apex, touch, spine, flux, proof, warden            |
   | `platform-infra` | apex, forge, relay, terra, kube, vigil, warden     |
   | `security-audit` | apex, warden, red, blue, hunt, patch, chain, sast  |
   | `ml-product`     | apex, cortex, flux, feat, fit, score, drift, embed |

   Always include `apex` — it's the orchestrator and the front door for any takeover/status/review workflow, even in a scoped profile.

3. **Ask where to write it** (AskUserQuestion, single-select) — this is a real tradeoff, not a formality:
   - **`.claude/settings.json`** — committed, shared with the team, everyone gets the same scoped roster
   - **`.claude/settings.local.json`** — gitignored, this developer only, doesn't affect teammates

4. **Merge, don't overwrite.** Read the target file if it exists (else start from `{}`). Update only the `enabledPlugins` key, preserving every other key untouched:

   ```bash
   python3 - "$TARGET_FILE" "$ROSTER_CSV" <<'PYEOF'
   import json, sys, pathlib

   target = pathlib.Path(sys.argv[1])
   roster = [a.strip() for a in sys.argv[2].split(",") if a.strip()]

   data = json.loads(target.read_text()) if target.exists() else {}
   plugins = data.setdefault("enabledPlugins", {})

   if roster:
       plugins["tonone@tonone-ai"] = False
       for agent in roster:
           plugins[f"{agent}@tonone-ai"] = True
   else:
       # full roster / undo
       plugins["tonone@tonone-ai"] = True
       for key in list(plugins):
           if key != "tonone@tonone-ai" and key.endswith("@tonone-ai"):
               del plugins[key]

   target.parent.mkdir(parents=True, exist_ok=True)
   target.write_text(json.dumps(data, indent=2) + "\n")
   PYEOF
   ```

5. **Report.** Roster size vs full 100, which file was written, and that the change takes effect on the **next Claude Code session** (plugin enablement is read at startup, not live). Note each enabled agent brings its own skills automatically (e.g. `spine@tonone-ai` includes `spine-api`, `spine-design`, etc. — no separate skill toggles needed). If output exceeds the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, and the report path.

## Notes

- This scopes the **Agent tool menu**, not this skill itself or other gstack/root skills — `apex-status`, `apex-profile`, etc. stay available regardless of roster.
- Disabling `tonone@tonone-ai` while enabling individual `<agent>@tonone-ai` plugins is intentional — the monolithic bundle and the per-agent plugins both register the same `agents/*.md` files, so leaving the bundle on defeats the scoping.
- If unsure which agents a project needs, run `/apex-stats` first — it's the evidence this skill should act on. On a repository with no usage history yet, the **Detected shape** option is the substitute: `apex-stats` reads what has been used, the detector reads what the project _is_.
- `/tonone-onboard` calls this skill with an already-detected roster as a **Custom list**. It recommends; this skill writes. Neither writes `enabledPlugins` twice, and the roster is never negotiated in both places.
- **Recommended default:** install the lean core (the preset, not the full 100) and lean on `/apex-route` for occasional long-tail needs — that combination gets a small "Available agent types" listing every session AND full access to all 100 specialists. Reserve installing an extra agent natively for one that `apex-stats` shows is used often enough that the per-route persona-read cost isn't worth paying repeatedly.

