go

$npx mdskill add Soul-Brews-Studio/arra-oracle-skills-cli/go

Manage global skill profiles and enable or disable capabilities.

  • Adjusts agent capabilities to match project requirements or experimental needs.
  • Depends on the arra-oracle-skills CLI binary for execution.
  • Parses command arguments to select the appropriate profile or action.
  • Executes the selected command directly via the detected CLI path.

SKILL.md

.github/skills/goView on GitHub ↗
---
name: go
description: Switch skill profiles (standard/full/lab), fresh install, or enable/disable specific skills via arra-oracle-skills CLI. Destructive — modifies globally installed skills.
argument-hint: "<standard|full|lab|cleanup> | enable|disable <skill...>"
disable-model-invocation: true
---

# /go

> Switch gear. Single source of truth.

## Usage

```
/go                     # show installed skills
/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 enable trace dig    # enable specific skills
/go disable watch       # disable specific skills
```

---

## 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` (no args) — show current state

```bash
$ARRA list -g
```

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

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

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

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

### `/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  auto-retrospective       full       ✓          v3.7.2    ✓ ok         2
  3  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 auto-retrospective 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 enable <skill...>` — enable specific skills

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

- `/go enable trace dig` → `$ARRA install -g -s trace dig -y`

### `/go disable <skill...>` — disable specific skills

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

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

---

## Available Profiles

| Profile | Count | Description |
|---------|-------|-------------|
| **standard** | 14 | Daily driver — essential Oracle skills (default) |
| **full** | 21 | All stable skills (excludes lab-only) |
| **lab** | 29 | Everything including experimental |

---

## 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

More from Soul-Brews-Studio/arra-oracle-skills-cli

SkillDescription
about-oracleWhat is Oracle — told by the AI itself. Origin story, stats, family count, ecosystem overview. Use when someone asks "what is oracle", "about oracle", "tell me about this project", or wants the origin story. Do NOT trigger for "who are you" (use /who-are-you), "philosophy" (use /philosophy), or session status questions.
alpha-featureFull skill development pipeline — create, compile, test, commit, install. Use when user says "new skill", "create skill", "alpha-feature", or wants to build a skill end-to-end.
auto-retrospectiveConfigure auto-rrr and auto-forward triggers based on context window usage. Use when user says "auto rrr", "auto-scale", "configure auto triggers", "change rrr interval", "toggle auto", or wants to adjust when /rrr and /forward auto-trigger. Do NOT trigger for running /rrr manually (use /rrr) or creating handoffs (use /forward).
awakenGuided Oracle birth and awakening ritual. Default is Soul Sync (~20min), or --fast (~5min). Use when creating a new Oracle in a fresh repo, when user says 'awaken', 'birth oracle', 'create oracle', 'new oracle', or wants to set up Oracle identity in an empty repository. Do NOT trigger for general repo setup, git init, or project scaffolding without Oracle context.
bampenpienบำเพ็ญเพียร — diligent practice. A guided conversation between human and Oracle about doing hard things without knowing why. Like /awaken but repeatable — a practice, not a birth. Use when user says 'bampenpien', 'บำเพ็ญเพียร', 'why am I doing this', 'hard work', 'keep going', 'what am I building', or needs to reconnect with purpose through difficulty.
birthPrepare Oracle birth props for a new repo — Issue #1, MCP thread, identity data. Use when user says "birth", "new oracle", "prepare repo", or wants to bootstrap a new Oracle before /awaken.
budCreate a new oracle via maw bud — yeast-colony reproduction. Use when user says "bud", "new oracle", "create oracle", "spawn oracle", or wants to create a new permanent oracle from the current one.
create-shortcutCreate local skills as shortcuts — makes real /commands in .claude/skills/. Use when user says "create shortcut", "create skill", "make a command for", "add shortcut", or wants a quick custom /slash-command. Also lists and deletes local skills. ALSO triggers on "Unknown skill", "skill not found", or any unrecognized /slash-command — auto-creates it on the fly.
digMine Claude Code sessions — timeline, gaps, repo attribution, session history. Use when user says "dig", "sessions", "past sessions", "timeline", "what did I work on", or wants to see session history. Do NOT trigger for finding code/projects (use /trace), exploring repos (use /learn), or current session status (use /recap).
feelCapture how the system feels — energy, momentum, burnout, breakthrough. Emotional intelligence for Oracle-human collaboration. Use when user says 'feel', 'how are we', 'energy check', 'burnout', 'momentum', or wants emotional awareness of the work.