Go

---
name: go
description: Manage Oracle skills — list, install, remove, find, switch profiles, update. Use when user says "go", "install skill", "remove skill", "find skill", "switch profile", "go list", "go update", "go install", "go find". Single entry point for all skill management.
argument-hint: "[list] | <standard|full|lab|cleanup|update> | install|remove|find <skill...>"
disable-model-invocation: true
---

# /go

> Switch gear. Single source of truth.

## Usage

```
/go                     # all skills — profile tier + installed status
/go list                # same as /go (no args)
/go minimal             # newcomer essentials (7 skills, default)
/go standard            # daily driver (13 skills)
/go full                # all stable (excludes lab-only experiments)
/go lab                 # everything including experimental
/go cleanup             # remove ALL skills → fetch latest → fresh install
/go update              # check for new version + upgrade in-place
/go install team-agents # cherry-pick install specific skills
/go remove watch        # uninstall specific skills
/go find feel           # search all available skills by name
```

> ⚠ NEW (#285): `/go <profile>` now ALIGNS your installed skills to the target profile.
> arra-managed skills NOT in the target profile will be **removed**.
> External / non-arra skills are never touched.
> A pre-removal diff is shown before any deletion occurs.

---

## CLI Detection

Before running any command, detect the CLI path. It may not be in `$PATH` on all machines.

```bash
# Try in order: global binary, bun global, bunx fallback
if command -v arra-oracle-skills &>/dev/null; then
  ARRA="arra-oracle-skills"
elif [ -x "$HOME/.bun/bin/arra-oracle-skills" ]; then
  ARRA="$HOME/.bun/bin/arra-oracle-skills"
else
  # Not installed — use bunx (always works if bun exists)
  ARRA="$HOME/.bun/bin/bunx --bun arra-oracle-skills@github:Soul-Brews-Studio/arra-oracle-skills-cli"
fi
```

Use `$ARRA` for all commands below.

---

## Execution

Parse the user's `/go` arguments and run the matching `$ARRA` command.

### `/go` or `/go list` — show all skills with profile + installed status + type

Write this script to `/tmp/go-list.sh` and run it with `bash /tmp/go-list.sh`. The script auto-discovers profile membership from the CLI — zero hardcoded skill names.

```bash
#!/bin/bash
SKILLS_DIR="$HOME/.claude/skills"
ARRA="$HOME/.bun/bin/arra-oracle-skills"
VERSION=$($ARRA --version 2>/dev/null || echo "?")

# Auto-get skill lists from CLI (no hardcoding)
get_profile_skills() {
  $ARRA profiles "$1" 2>/dev/null | grep "Skills:" | sed 's/.*Skills: //' | tr ',' '\n' | sed 's/^ *//' | tr '\n' ' '
}

STANDARD=$(get_profile_skills standard)
FULL=$(get_profile_skills full)
LAB_RAW=$(get_profile_skills lab)

# Lab-only = in lab but not in full
LAB=""
for s in $LAB_RAW; do
  echo " $FULL " | grep -q " $s " || LAB="$LAB $s"
done

# Minimal-only = in minimal but not in standard
MINIMAL=$(get_profile_skills minimal)
MINIMAL_ONLY=""
for s in $MINIMAL; do
  echo " $STANDARD " | grep -q " $s " || MINIMAL_ONLY="$MINIMAL_ONLY $s"
done

ALL_ARRA="$STANDARD $LAB $MINIMAL_ONLY"

detect_type() {
  local dir="$SKILLS_DIR/$1"
  [ -d "$dir" ] || return
  local has_code=false has_agent=false
  [ -d "$dir/scripts" ] && has_code=true
  grep -qlE 'Agent\(|subagent|TeamCreate|SendMessage' "$dir/SKILL.md" 2>/dev/null && has_agent=true
  if $has_code && $has_agent; then echo "[code+agent]"
  elif $has_code; then echo "[code]"
  elif $has_agent; then echo "[agent]"
  fi
}

get_desc() {
  local f="$SKILLS_DIR/$1/SKILL.md"
  [ -f "$f" ] || return
  awk '/^---$/{n++; next} n==1{print} n>=2{exit}' "$f" \
    | grep -E '^description:' | head -1 \
    | sed "s/description: *//; s/['\"]//g; s/\[core\].*G-SKLL | //" \
    | cut -c1-40
}

echo "Oracle Skills v$VERSION"
echo ""

NUM=0; INSTALLED=0
std_count=$(echo $STANDARD | wc -w | tr -d ' ')
lab_count=$(echo $LAB | wc -w | tr -d ' ')
min_count=$(echo $MINIMAL_ONLY | wc -w | tr -d ' ')

for tier in STANDARD LAB MINIMAL_ONLY; do
  case $tier in
    STANDARD) skills="$STANDARD"; label="standard"; count=$std_count ;;
    LAB) skills="$LAB"; label="lab"; count=$lab_count ;;
    MINIMAL_ONLY) skills="$MINIMAL_ONLY"; label="minimal-only"; count=$min_count ;;
  esac
  [ -z "$(echo $skills | tr -d ' ')" ] && continue
  printf " ─── %s (%s) " "$label" "$count"
  printf '─%.0s' $(seq 1 $((52 - ${#label}))); echo ""
  for name in $skills; do
    NUM=$((NUM+1))
    if [ -d "$SKILLS_DIR/$name" ]; then
      mark="✓"; INSTALLED=$((INSTALLED+1))
    else
      mark="✗"
    fi
    tag=$(detect_type "$name")
    desc=$(get_desc "$name")
    if [ -n "$desc" ]; then
      printf " %2d  %s  %-24s %-14s %s\n" "$NUM" "$mark" "$name" "$tag" "$desc"
    else
      printf " %2d  %s  %-24s %s\n" "$NUM" "$mark" "$name" "$tag"
    fi
  done
  echo ""
done

# External (non-arra) skills
EXT=0; EXT_NAMES=""
for dir in "$SKILLS_DIR"/*/; do
  [ -d "$dir" ] || continue
  name=$(basename "$dir"); [ "$name" = ".trash" ] && continue
  is_arra=false
  for a in $ALL_ARRA; do [ "$name" = "$a" ] && is_arra=true && break; done
  [ "$is_arra" = "false" ] && { EXT=$((EXT+1)); EXT_NAMES="$EXT_NAMES $name"; }
done
if [ "$EXT" -gt 0 ]; then
  printf " ─── external (%d) " "$EXT"
  printf '─%.0s' $(seq 1 44); echo ""
  for name in $EXT_NAMES; do
    NUM=$((NUM+1)); INSTALLED=$((INSTALLED+1))
    tag=$(detect_type "$name")
    desc=$(get_desc "$name")
    if [ -n "$desc" ]; then
      printf " %2d  ✓  %-24s %-14s %s\n" "$NUM" "$name" "$tag" "$desc"
    else
      printf " %2d  ✓  %-24s %s\n" "$NUM" "$name" "$tag"
    fi
  done
  echo ""
fi

echo " $INSTALLED/$NUM installed  ·  zombies hidden (--zombies to show)"
echo " Cherry-pick:  arra-oracle-skills install -g -s <name> -y"
echo " Switch:       /go standard | /go lab"
```

**Auto-detected columns:**
- **Profile tier**: from `arra-oracle-skills profiles <name>` CLI output (zero hardcoded names)
- **Type tags**: runtime detection from installed SKILL.md — `[code]` (scripts/), `[agent]` (Agent patterns), `[code+agent]` (both)
- **Description**: parsed from installed SKILL.md frontmatter, truncated to 40 chars
- **Installed**: checks `$HOME/.claude/skills/<name>/` exists

**`--zombies` flag**: append zombie skills section. Only shown when explicitly requested.

### `/go <profile>` — switch profile

```bash
$ARRA install -g --profile <name> -y
```

Profiles: `minimal`, `standard`, `full`, `lab`

- `/go minimal` → `$ARRA install -g --profile minimal -y`
- `/go standard` → `$ARRA install -g --profile standard -y`
- `/go full` → `$ARRA install -g --profile full -y`
- `/go lab` → `$ARRA install -g --profile lab -y`

> Note: passing `--profile` explicitly triggers alignment — arra-managed skills NOT in the target
> are removed automatically. External skills are never touched.

### `/go cleanup` — fresh install (safe)

Crosscheck installed skills, remove stale arra-managed ones, fetch latest, reinstall. External skills are never touched.

**Step 1: Crosscheck** — list all installed skills, classify by `installer:` field in SKILL.md:

```bash
SKILLS_DIR="$HOME/.claude/skills"
LATEST=$(curl -s https://api.github.com/repos/Soul-Brews-Studio/arra-oracle-skills-cli/tags | grep -m1 '"name"' | cut -d'"' -f4)

echo "📋 Crosscheck (latest: $LATEST):"
ARRA_COUNT=0; EXT_COUNT=0; STALE_COUNT=0; CONFLICT_COUNT=0
for dir in "$SKILLS_DIR"/*/; do
  [ -d "$dir" ] || continue
  name=$(basename "$dir")
  version=$(grep -o 'v[0-9][0-9.]*' "$dir/SKILL.md" 2>/dev/null | head -1)
  installer=$(grep 'installer:' "$dir/SKILL.md" 2>/dev/null | head -1)

  if echo "$installer" | grep -q "arra-oracle"; then
    # Arra-managed skill — check version
    if [ "$version" = "$LATEST" ]; then
      echo "  ✓ arra: $name ($version)"
      ARRA_COUNT=$((ARRA_COUNT + 1))
    else
      echo "  ⚠️ stale: $name ($version → $LATEST)"
      STALE_COUNT=$((STALE_COUNT + 1))
    fi
  else
    echo "  ○ external: $name — will keep"
    EXT_COUNT=$((EXT_COUNT + 1))
  fi
done
echo ""
echo "  Summary: $ARRA_COUNT ok, $STALE_COUNT stale, $EXT_COUNT external"
```

**Step 2: Combined table** — crosscheck + usage in ONE table. Mine session JSONL files, then display everything together:

```bash
# Mine usage data from all sessions
TOTAL=0
for jsonl in ~/.claude/projects/*/*.jsonl; do
  [ -f "$jsonl" ] || continue
  TOTAL=$((TOTAL + 1))
done
```

Build the combined table. For each of the 29 arra skills, show: profile tier, installed status, version, status, and usage count from session mining.

```
📋 Skills Overview (29 arra + N external) — $TOTAL sessions mined:

  #  Skill                    Profile    Installed  Version   Status       Usage
  ── ──────────────────────── ────────── ────────── ───────── ──────────── ─────
  1  about-oracle             standard   ✓          v3.7.2    ✓ ok         2
  2  awaken                   standard   ✓          v3.7.2    ✓ ok         7
  4  contacts                 lab        ✓          v3.7.2    ✓ ok         5
  5  create-shortcut          lab        ✗          —         —            3
  6  dig                      standard   ✓          v3.7.2    ✓ ok         6
  7  dream                    lab        ✗          —         —            5
  8  feel                     lab        ✗          —         —            4
  9  forward                  standard   ✓          v3.7.2    ✓ ok         4
  10 go                       standard   ✓          v3.7.2    ✓ ok         3
  11 inbox                    lab        ✓          v3.7.2    ✓ ok         4
  12 incubate                 full       ✓          v3.7.2    ✓ ok         6
  13 learn                    standard   ✓          v3.7.2    ✓ ok         7
  14 oracle-family-scan       standard   ✓          v3.7.2    ✓ ok         4
  15 oracle-soul-sync-update  standard   ✓          v3.7.2    ✓ ok         3
  16 philosophy               full       ✗          —         —            4
  17 project                  full       ✗          —         —            6
  18 recap                    standard   ✓          v3.7.2    ✓ ok         7
  19 resonance                full       ✗          —         —            6
  20 rrr                      standard   ✓          v3.7.2    ✓ ok         7
  21 schedule                 lab        ✗          —         —            3
  22 standup                  standard   ✓          v3.7.2    ✓ ok         3
  23 talk-to                  standard   ✓          v3.7.2    ✓ ok         6
  24 team-agents              lab        ✗          —         —            1
  25 trace                    standard   ✓          v3.7.2    ✓ ok         5
  26 vault                    lab        ✗          —         —            5
  27 where-we-are             full       ✗          —         —            4
  28 who-are-you              full       ✓          v1.0.22   ⚠️ stale     6
  29 xray                     standard   ✓          v3.7.2    ✓ ok         4

  External (will keep):
  ○ drink, mawjs, mawjs-local, ultrathink

  💡 Skills with 0 usage might not need to be in your profile.
```

**How to get usage counts**: for each skill, count sessions containing `/$skill`:

```bash
for skill in about-oracle awaken contacts create-shortcut \
  dig dream feel forward go inbox incubate learn oracle-family-scan \
  oracle-soul-sync-update philosophy project recap resonance rrr \
  schedule standup talk-to team-agents trace vault where-we-are who-are-you xray; do
  count=$(grep -rl "/$skill" ~/.claude/projects/*/*.jsonl 2>/dev/null | wc -l)
  echo "$count $skill"
done | sort -rn
```

Status legend:
- `✓ ok` — arra-managed, current version
- `⚠️ stale` — arra-managed but outdated (needs update)
- `—` — not installed (available in higher profile)

**Step 3: Confirm** — now with full context:

```
Proceed with cleanup?
  - Conflicts will be replaced (backed up to .bak)
  - External skills kept untouched
  - Which profile? [standard / full / lab]
```

**Step 4: Clean + reinstall** (only after user confirms):

```bash
# Uninstall arra-managed via CLI
$ARRA uninstall -g -y

# For each conflict skill: rename to .bak (Nothing is Deleted)
for name in [conflicting skills]; do
  mv "$SKILLS_DIR/$name" "$SKILLS_DIR/${name}.bak.$(date +%s)"
done

# Fresh install at latest
LATEST=$(curl -s https://api.github.com/repos/Soul-Brews-Studio/arra-oracle-skills-cli/tags | grep -m1 '"name"' | cut -d'"' -f4)
~/.bun/bin/bunx --bun arra-oracle-skills@github:Soul-Brews-Studio/arra-oracle-skills-cli#$LATEST install -g -y
```

**Output:**
```
🧹 Cleanup complete!
  Kept: [N] external skills
  Replaced: [N] conflicts (backed up to .bak)
  Installed: [N] fresh at $LATEST
  Restart required.
```

**When to use:**
- Stale skills from old versions mixed with new
- `[hidden]` flags persisting after unhide
- Version mismatch (some v3.6.1, some v3.7.0)
- Want a clean slate without losing personal skills

### `/go update` — check for new version + upgrade in-place

```bash
CURRENT=$($ARRA --version 2>/dev/null || echo "unknown")
LATEST=$(curl -s https://api.github.com/repos/Soul-Brews-Studio/arra-oracle-skills-cli/tags | grep -m1 '"name"' | cut -d'"' -f4)
echo "  Installed: $CURRENT"
echo "  Latest:    $LATEST"
```

If versions differ:

```bash
$ARRA install -g -y
```

If already current: "Already on latest ($CURRENT). Nothing to do."

- `/go update` → check + upgrade to latest tag
- Equivalent to `/oracle-soul-sync-update` but discoverable under `/go`
- Does NOT change your profile — only bumps the version of currently installed skills
- Safe to run anytime — idempotent

### `/go install <skill...>` — cherry-pick specific skills

```bash
$ARRA install -g -s <skill...> -y
```

- `/go install team-agents` → `$ARRA install -g -s team-agents -y`
- `/go install dig hey xray` → `$ARRA install -g -s dig hey xray -y`

Works for ANY skill — standard, lab, or even zombie. Does not change your profile; just adds the named skills on top of whatever you have.

### `/go remove <skill...>` — uninstall specific skills

```bash
$ARRA uninstall -g -s <skill...> -y
```

- `/go remove watch` → `$ARRA uninstall -g -s watch -y`

### `/go find <query>` — search available skills

```bash
$ARRA profiles lab 2>/dev/null
```

Show all skills from the lab profile (the superset) and highlight any matching the query. If the user says `/go find feel`, search the profile output for "feel" and show where it lives (which tier, installed or not).

- `/go find feel` → show feel is in lab tier, not installed, description
- `/go find team` → show team-agents in standard tier, installed

---

## Available Profiles

| Profile | Count | Description |
|---------|-------|-------------|
| **minimal** | 7 | Newcomer essentials — lite lifecycle, trace, update (token-optimized) |
| **standard** | 13 | Daily driver — essential Oracle skills |
| **full** | ~30 | All stable skills (excludes lab-only + minimal-only lite variants) |
| **lab** | ~48 | Everything including experimental (excludes minimal-only lite variants) |

---

## Rules

1. **Always `-g`** — global (user-level) skills
2. **Always `-y`** — skip confirmation
3. **Restart required** — agent loads skills at session start
4. **`go` is always preserved** — it's in every profile
5. **Show result** — after running the command, tell the user what changed and remind them to restart

---

ARGUMENTS: $ARGUMENTS