@glexcorp/gskp 0.1.1 → 0.1.2

package/src/cli/lifecycle.mjs

@@ -12,6 +12,7 @@ import {
   unlinkSync,
   writeFileSync
 } from 'node:fs';
+import { homedir } from 'node:os';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import {
@@ -33,7 +34,7 @@ const HIBERNATED_REACTIVATION_TEXT =
   'Reactivation requires a stable service/API, a known auth contract, and updated smoke tests.';
 const TOOLS = ['claude', 'codex'];
 const AGENT_DOCS = ['AGENTS.md', 'CLAUDE.md'];
-const KNOWN_PROVISION_AGENTIC_CONFIG_VERSIONS = new Set(['v0.5', 'v0.6', 'v0.7', 'v0.8', 'v0.9', 'v0.10']);
+const KNOWN_PROVISION_AGENTIC_CONFIG_VERSIONS = new Set(['v0.5', 'v0.6', 'v0.7', 'v0.8', 'v0.9', 'v0.10', 'v0.11']);
 const moduleDir = dirname(fileURLToPath(import.meta.url));
 const packageRoot = resolve(moduleDir, '..', '..');
 const checkoutRoot = resolve(packageRoot, '..', '..');
@@ -126,7 +127,7 @@ function packSkillEntries(manifest, packName, tool) {
 
 function baseSkillEntries(manifest, tool) {
   return manifestSkills(manifest).filter((skill) => {
-    return skill.scope === 'global' && skill.platform === tool && skill.path;
+    return skill.scope === 'base' && skill.platform === tool && skill.path;
   });
 }
 
@@ -144,7 +145,7 @@ function uniqueBaseSkillNames(manifest) {
   return [
     ...new Set(
       manifestSkills(manifest)
-        .filter((skill) => skill.scope === 'global' && skill.name)
+        .filter((skill) => skill.scope === 'base' && skill.name)
         .map((skill) => skill.name)
     )
   ].sort((a, b) => a.localeCompare(b));
@@ -269,11 +270,11 @@ function managedMarkerField(target, field) {
 
 function sourceOwnedBySkillpacks(source) {
   const ownedPrefixes = [
-    join(packageRoot, 'global', 'claude'),
-    join(packageRoot, 'global', 'codex'),
+    join(packageRoot, 'base', 'claude'),
+    join(packageRoot, 'base', 'codex'),
     join(packageRoot, 'packs'),
-    join(checkoutRoot, 'global', 'claude'),
-    join(checkoutRoot, 'global', 'codex'),
+    join(checkoutRoot, 'base', 'claude'),
+    join(checkoutRoot, 'base', 'codex'),
     join(checkoutRoot, 'packs')
   ];
 
@@ -614,7 +615,7 @@ function staleProjectPackError(pack, location, reason = '') {
   const detail = reason ? ` ${reason}` : '';
   return new Error(
     `Stale pack entry '${pack}' in .agents/project.json ${location}.${detail} ` +
-      `Run 'npx @glexcorp/gskp remove ${pack}' or edit .agents/project.json to remove or rename it.`
+      `Run 'npx skillpacks remove ${pack}' or edit .agents/project.json to remove or rename it.`
   );
 }
 
@@ -887,6 +888,29 @@ export async function initProject({ manifest, projectRoot = process.cwd() }) {
   });
 }
 
+export async function uninstallGlobal({ homeRoot = homedir() } = {}) {
+  let removed = 0;
+
+  for (const tool of TOOLS) {
+    const root = join(homeRoot, `.${tool}`, 'skills');
+    if (!existsSync(root)) {
+      continue;
+    }
+
+    for (const entry of readdirSync(root).sort((a, b) => a.localeCompare(b))) {
+      const target = join(root, entry);
+      if (removeRepoSkillInstall(target)) {
+        console.log(`Removed ${relative(homeRoot, target)}`);
+        removed += 1;
+      }
+    }
+  }
+
+  console.log(`Done. Removed ${removed} repo-managed base skill install(s) from ${homeRoot}.`);
+  console.log('Base skills now install project-local via `npx skillpacks init`.');
+  return 0;
+}
+
 export async function installResolved({ manifest, projectRoot = process.cwd(), packs = [], skills = [] }) {
   return withProjectLock(projectRoot, `install ${[...packs, ...skills].join(' ')}`.trim(), async () => {
     for (const pack of packs) {
@@ -983,7 +1007,7 @@ function pruneOrphanedSkillRoots({ manifest, projectRoot, dryRun = false }) {
 }
 
 function provisionerSkillText() {
-  const sourcePath = resolvePackagedPath('global/codex/provision-agentic-config/SKILL.md');
+  const sourcePath = resolvePackagedPath('base/codex/provision-agentic-config/SKILL.md');
   if (!existsSync(sourcePath)) {
     throw new Error(`Cannot find canonical provision-agentic-config skill at ${sourcePath}`);
   }
@@ -1202,6 +1226,10 @@ export async function doctorProject({ manifest, projectRoot = process.cwd(), arg
   console.log(`Project skill update mode: ${mode}`);
   console.log('Skill install drift (.claude/skills, .codex/skills):');
 
+  const refreshCmd = existsSync(join(checkoutRoot, '.git'))
+    ? `${checkoutRoot}/scripts/pack.sh refresh`
+    : 'npx skillpacks refresh';
+
   let found = false;
   let anyStale = false;
   for (const target of installedSkillTargets(projectRoot)) {
@@ -1220,7 +1248,7 @@ export async function doctorProject({ manifest, projectRoot = process.cwd(), arg
         console.log(`  pinned   ${rel} (frozen ${status.recordedVersion || '?'})`);
         break;
       case 'unknown':
-        console.log(`  unknown  ${rel} — run refresh to enable drift tracking`);
+        console.log(`  unknown  ${rel} — run \`${refreshCmd}\` to enable drift tracking`);
         break;
       case 'missing-source':
         console.log(`  missing  ${rel} — canonical source no longer exists`);
@@ -1242,7 +1270,7 @@ export async function doctorProject({ manifest, projectRoot = process.cwd(), arg
 
   if (anyStale) {
     console.log('');
-    console.log('Fix: npx @glexcorp/gskp refresh (or scripts/pack.sh refresh from a source checkout)');
+    console.log(`Fix: ${refreshCmd}`);
     return 1;
   }
 

package/src/cli/pack-normalization.mjs

@@ -440,7 +440,7 @@ function allPacksExist(packs, activePacks) {
 }
 
 function unknownNameError(token, manifest) {
-  return new Error(`Unknown pack or skill '${token}'. Available packs: ${availablePacksInline(manifest)}\nRun 'npx @glexcorp/gskp list' to see all available skills.`);
+  return new Error(`Unknown pack or skill '${token}'. Available packs: ${availablePacksInline(manifest)}\nRun 'npx skillpacks list' to see all available skills.`);
 }
 
 function hibernatedPackError(requested, pack) {

package/src/cli/run-pack-script.mjs

@@ -17,6 +17,7 @@ import {
   pruneProject,
   refreshProject,
   removeResolved,
+  uninstallGlobal,
   unpinSkill
 } from './lifecycle.mjs';
 
@@ -25,7 +26,6 @@ const packageRoot = resolve(moduleDir, '..', '..');
 const checkoutRoot = resolve(packageRoot, '..', '..');
 const packageJsonPath = join(packageRoot, 'package.json');
 const packScriptPath = resolvePackagedPath('scripts/pack.sh');
-const initScriptPath = resolvePackagedPath('init.sh');
 const manifestPath = resolvePackagedPath('dist/skillpacks-manifest.json');
 const alignmentUpgradeScriptPath = resolvePackagedPath('scripts/upgrade-alignment-page.mjs');
 const alignmentAuditScriptPath = resolvePackagedPath('scripts/audit-alignment-pages.mjs');
@@ -116,11 +116,6 @@ function runCommand(command, args, options = {}) {
   });
 }
 
-function runGlobalInit(args) {
-  requireCommand('bash', 'Install bash before running gskp.');
-  return runCommand('bash', [initScriptPath, ...args]);
-}
-
 function assertNoArgs(command, args) {
   if (args.length > 0) {
     throw new Error(`${command} does not accept arguments`);
@@ -364,7 +359,7 @@ Commands:
   install <name...>            Enable packs or individual skills
   install-deck <deck> [--full] Enable packs selected by deck metadata
   init                         Install base skills into this project
-  init --global [args...]      Install user-home global core skills with packaged init.sh
+  uninstall-global             Remove legacy repo-managed base skills from ~/.claude and ~/.codex
   remove <name...>             Remove packs or individual skills
   refresh                      Recreate local skill roots from project config
   doctor                       Report skill-install drift
@@ -383,7 +378,6 @@ Commands:
   unpin <skill>                Revert a pinned skill to latest
   set-mode <mode>              Set project agent mode
   which <skill>                Show which pack provides a skill
-  init-global [args...]        Alias for init --global
 
 Project-local commands write to the current working directory.`);
 }
@@ -433,8 +427,9 @@ export async function runSkillpacksCli(args) {
     return setUpdateMode(rest[0]);
   }
 
-  if (command === 'init-global') {
-    return runGlobalInit(rest);
+  if (command === 'uninstall-global') {
+    assertNoArgs('uninstall-global', rest);
+    return uninstallGlobal();
   }
 
   if (command === 'install-deck') {
@@ -452,13 +447,8 @@ export async function runSkillpacksCli(args) {
   }
 
   if (command === 'init') {
-    if (rest[0] === '--global') {
-      return runGlobalInit(rest.slice(1));
-    }
     if (rest.length > 0) {
-      throw new Error(
-        "init does not accept arguments except '--global'. Use 'gskp init --global' for user-home global core skills."
-      );
+      throw new Error('init does not accept arguments');
     }
     return initProject({
       manifest: readManifest(),

package/src/cli/update-check.mjs

@@ -62,7 +62,7 @@ export async function printUpdateNotice(checkPromise, currentVersion) {
     if (compareVersions(currentVersion, latest) >= 0) return;
 
     const msg = `  Update available: ${currentVersion} → ${latest}`;
-    const run = '  Run: npx @glexcorp/gskp@latest';
+    const run = '  Run: npx skillpacks@latest';
     const width = Math.max(msg.length, run.length) + 2;
     const pad = (s) => s + ' '.repeat(width - s.length);
     const border = '─'.repeat(width);

package/global/claude/init-agentic-skills/scripts/init-agentic-skills.sh

@@ -1,227 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
-DELEGATE_SCRIPT="init.sh"
-
-resolve_repo_root() {
-  local source_tree_root
-  if source_tree_root="$(cd "$SKILL_DIR/../../.." 2>/dev/null && pwd -P)"; then
-    if [ -f "$source_tree_root/$DELEGATE_SCRIPT" ]; then
-      printf '%s\n' "$source_tree_root"
-      return 0
-    fi
-  else
-    source_tree_root="<unresolved>"
-  fi
-
-  local managed_file="$SKILL_DIR/.agentic-skills-managed"
-  local managed_source=""
-  if [ -f "$managed_file" ]; then
-    while IFS= read -r line; do
-      case "$line" in
-        source=*)
-          managed_source="${line#source=}"
-          break
-          ;;
-      esac
-    done < "$managed_file"
-  fi
-
-  local provenance_root="<unresolved>"
-  if [ -n "$managed_source" ] && [ -d "$managed_source" ]; then
-    if provenance_root="$(cd "$managed_source/../../.." 2>/dev/null && pwd -P)"; then
-      if [ -f "$provenance_root/$DELEGATE_SCRIPT" ]; then
-        printf '%s\n' "$provenance_root"
-        return 0
-      fi
-    else
-      provenance_root="<unresolved>"
-    fi
-  fi
-
-  {
-    echo "ERROR: Unable to resolve agentic-skills repository root for init-agentic-skills launcher."
-    echo "Tried source-tree candidate: $source_tree_root"
-    echo "Tried managed-install provenance: $managed_file source=${managed_source:-<missing>} -> $provenance_root"
-    echo "Expected delegated script: $DELEGATE_SCRIPT"
-  } >&2
-  return 1
-}
-
-REPO_ROOT="$(resolve_repo_root)"
-
-PREFERENCES_FILE="$HOME/.agentic-skills/preferences.json"
-SETTINGS_FILE="$HOME/.claude/settings.json"
-DRIFT_HOOK_CMD="bash $REPO_ROOT/scripts/skill-drift-hook.sh"
-
-status() {
-  echo "agentic-skills checkout: $REPO_ROOT"
-  git -C "$REPO_ROOT" rev-parse --short HEAD 2>/dev/null | sed 's/^/local commit: /' || true
-  git -C "$REPO_ROOT" remote get-url origin 2>/dev/null | sed 's/^/remote URL: /' || echo "remote URL: unavailable"
-
-  if [ -f "$PREFERENCES_FILE" ]; then
-    python3 -c 'import json, pathlib, sys
-path = pathlib.Path(sys.argv[1])
-try:
-    value = json.loads(path.read_text()).get("sync", {}).get("github_freshness_check")
-except Exception:
-    value = None
-print("github freshness preference: " + (value if value in {"ask", "always", "never"} else "unset"))' "$PREFERENCES_FILE"
-  else
-    echo "github freshness preference: unset"
-  fi
-}
-
-doctor() {
-  # shellcheck source=/dev/null
-  source "$REPO_ROOT/scripts/skill-links.sh" || { echo "ERROR: unable to load skill-links.sh" >&2; return 1; }
-  echo "Global skill install drift (~/.claude/skills, ~/.codex/skills):"
-  local found=false any_stale=false target line status rec cur
-  while IFS= read -r target; do
-    [ -n "$target" ] || continue
-    line="$(skill_install_status "$target")"
-    IFS=$'\t' read -r status rec cur <<< "$line"
-    [ "$status" = "not-managed" ] && continue
-    found=true
-    case "$status" in
-      ok)             printf '  ok       %s\n' "$target" ;;
-      pinned)         printf '  pinned   %s (frozen %s)\n' "$target" "${rec:-?}" ;;
-      unknown)        printf '  unknown  %s — rerun init to enable drift tracking\n' "$target" ;;
-      missing-source) printf '  missing  %s — canonical source no longer exists\n' "$target" ;;
-      stale)          printf '  STALE    %s (%s -> %s)\n' "$target" "${rec:-?}" "${cur:-?}"; any_stale=true ;;
-    esac
-  done < <(find "$HOME/.claude/skills" "$HOME/.codex/skills" -mindepth 1 -maxdepth 1 \( -type l -o -type d \) -print 2>/dev/null | sort)
-  $found || echo "  (no managed global skill installs found)"
-  if $any_stale; then
-    echo ""
-    echo "Fix: /init-agentic-skills update  (re-copies global skills from this checkout)"
-    return 1
-  fi
-  return 0
-}
-
-set_pref() {
-  local key="$1" val="$2" jqval
-  case "$key" in
-    session_start_hook|auto_refresh) ;;
-    *) echo "ERROR: unknown preference '$key' (use session_start_hook or auto_refresh)" >&2; return 1 ;;
-  esac
-  case "$val" in
-    true) jqval=true ;;
-    false) jqval=false ;;
-    *) echo "ERROR: value must be true or false" >&2; return 1 ;;
-  esac
-  command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required to set preferences" >&2; return 1; }
-  mkdir -p "$(dirname "$PREFERENCES_FILE")"
-  [ -f "$PREFERENCES_FILE" ] || echo '{}' > "$PREFERENCES_FILE"
-  local tmp
-  tmp="$(jq --arg k "$key" --argjson v "$jqval" '.skills = ((.skills // {}) + {($k): $v})' "$PREFERENCES_FILE")" || { echo "ERROR: jq failed updating $PREFERENCES_FILE" >&2; return 1; }
-  [ -n "$tmp" ] || { echo "ERROR: jq produced empty output for $PREFERENCES_FILE" >&2; return 1; }
-  echo "$tmp" > "$PREFERENCES_FILE"
-  echo "Set skills.$key = $val in $PREFERENCES_FILE"
-}
-
-hook_enable() {
-  command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required to register the hook" >&2; return 1; }
-  mkdir -p "$(dirname "$SETTINGS_FILE")"
-  [ -f "$SETTINGS_FILE" ] || echo '{}' > "$SETTINGS_FILE"
-  local tmp
-  tmp="$(jq --arg cmd "$DRIFT_HOOK_CMD" '
-    .hooks = (.hooks // {})
-    | .hooks.SessionStart = (.hooks.SessionStart // [])
-    | if ([.hooks.SessionStart[]?.hooks[]? | select(.command == $cmd)] | length) > 0
-      then .
-      else .hooks.SessionStart += [ { "hooks": [ { "type": "command", "command": $cmd } ] } ]
-      end
-  ' "$SETTINGS_FILE")" || { echo "ERROR: jq failed updating $SETTINGS_FILE" >&2; return 1; }
-  [ -n "$tmp" ] || { echo "ERROR: jq produced empty output for $SETTINGS_FILE" >&2; return 1; }
-  echo "$tmp" > "$SETTINGS_FILE"
-  set_pref session_start_hook true
-  echo "Registered SessionStart drift hook in $SETTINGS_FILE"
-}
-
-hook_disable() {
-  set_pref session_start_hook false
-  command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required to remove the hook" >&2; return 1; }
-  [ -f "$SETTINGS_FILE" ] || { echo "No $SETTINGS_FILE; nothing to remove."; return 0; }
-  local tmp
-  tmp="$(jq --arg cmd "$DRIFT_HOOK_CMD" '
-    if .hooks.SessionStart then
-      .hooks.SessionStart = ([ .hooks.SessionStart[]
-        | .hooks = ([ .hooks[]? | select(.command != $cmd) ])
-        | select((.hooks | length) > 0) ])
-      | if (.hooks.SessionStart | length) == 0 then del(.hooks.SessionStart) else . end
-      | if (.hooks | length) == 0 then del(.hooks) else . end
-    else . end
-  ' "$SETTINGS_FILE")" || { echo "ERROR: jq failed updating $SETTINGS_FILE" >&2; return 1; }
-  [ -n "$tmp" ] || { echo "ERROR: jq produced empty output for $SETTINGS_FILE" >&2; return 1; }
-  echo "$tmp" > "$SETTINGS_FILE"
-  echo "Removed SessionStart drift hook from $SETTINGS_FILE"
-}
-
-show_prefs() {
-  if [ -f "$PREFERENCES_FILE" ] && command -v jq >/dev/null 2>&1; then
-    echo "session_start_hook: $(jq -r '.skills.session_start_hook // false' "$PREFERENCES_FILE")"
-    echo "auto_refresh:       $(jq -r '.skills.auto_refresh // false' "$PREFERENCES_FILE")"
-  else
-    echo "session_start_hook: false"
-    echo "auto_refresh:       false"
-  fi
-}
-
-confirm_update() {
-  if [ "${1:-}" = "--yes" ] || [ "${1:-}" = "-y" ]; then
-    return 0
-  fi
-  printf "Check GitHub, fast-forward this checkout if possible, and rerun init.sh? [y/N] "
-  read -r reply
-  case "$reply" in
-    y|Y|yes|YES) return 0 ;;
-    *) echo "Update cancelled."; return 1 ;;
-  esac
-}
-
-update_latest() {
-  confirm_update "${1:-}"
-  git -C "$REPO_ROOT" fetch origin
-  git -C "$REPO_ROOT" rev-parse --short HEAD | sed 's/^/local before: /'
-  git -C "$REPO_ROOT" rev-parse --short origin/HEAD | sed 's/^/origin HEAD: /'
-  git -C "$REPO_ROOT" merge --ff-only origin/HEAD
-  bash "$REPO_ROOT/$DELEGATE_SCRIPT"
-  echo "Refresh complete."
-  echo "Claude Code: run /reload-skills first; /clear starts a new empty-context conversation and can pick up the refreshed registry. Restart Claude Code if the top-level .claude/skills directory did not exist at session start or the skill is still invisible."
-  echo 'Codex: start a fresh Codex CLI session if the $ skill list remains stale.'
-}
-
-case "${1:-}" in
-  status)
-    status
-    ;;
-  doctor)
-    doctor
-    ;;
-  update|latest)
-    mode="$1"
-    shift
-    update_latest "${1:-}"
-    ;;
-  set-pref)
-    shift
-    set_pref "${1:-}" "${2:-}"
-    ;;
-  show-prefs)
-    show_prefs
-    ;;
-  hook)
-    shift
-    case "${1:-}" in
-      enable) hook_enable ;;
-      disable) hook_disable ;;
-      *) echo "Usage: init-agentic-skills.sh hook <enable|disable>" >&2; exit 2 ;;
-    esac
-    ;;
-  *)
-    exec bash "$REPO_ROOT/$DELEGATE_SCRIPT" "$@"
-    ;;
-esac

package/global/codex/init-agentic-skills/agents/openai.yaml

@@ -1,7 +0,0 @@
-interface:
-  display_name: "Init Agentic Skills"
-  short_description: "Initialize global Claude and Codex skills from this checkout"
-  default_prompt: "Use $init-agentic-skills to run the agentic-skills initializer, refresh global managed skill installs, and explain how to enable project-local packs."
-
-policy:
-  allow_implicit_invocation: true

package/global/codex/init-agentic-skills/scripts/init-agentic-skills.sh

@@ -1,227 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
-DELEGATE_SCRIPT="init.sh"
-
-resolve_repo_root() {
-  local source_tree_root
-  if source_tree_root="$(cd "$SKILL_DIR/../../.." 2>/dev/null && pwd -P)"; then
-    if [ -f "$source_tree_root/$DELEGATE_SCRIPT" ]; then
-      printf '%s\n' "$source_tree_root"
-      return 0
-    fi
-  else
-    source_tree_root="<unresolved>"
-  fi
-
-  local managed_file="$SKILL_DIR/.agentic-skills-managed"
-  local managed_source=""
-  if [ -f "$managed_file" ]; then
-    while IFS= read -r line; do
-      case "$line" in
-        source=*)
-          managed_source="${line#source=}"
-          break
-          ;;
-      esac
-    done < "$managed_file"
-  fi
-
-  local provenance_root="<unresolved>"
-  if [ -n "$managed_source" ] && [ -d "$managed_source" ]; then
-    if provenance_root="$(cd "$managed_source/../../.." 2>/dev/null && pwd -P)"; then
-      if [ -f "$provenance_root/$DELEGATE_SCRIPT" ]; then
-        printf '%s\n' "$provenance_root"
-        return 0
-      fi
-    else
-      provenance_root="<unresolved>"
-    fi
-  fi
-
-  {
-    echo "ERROR: Unable to resolve agentic-skills repository root for init-agentic-skills launcher."
-    echo "Tried source-tree candidate: $source_tree_root"
-    echo "Tried managed-install provenance: $managed_file source=${managed_source:-<missing>} -> $provenance_root"
-    echo "Expected delegated script: $DELEGATE_SCRIPT"
-  } >&2
-  return 1
-}
-
-REPO_ROOT="$(resolve_repo_root)"
-
-PREFERENCES_FILE="$HOME/.agentic-skills/preferences.json"
-SETTINGS_FILE="$HOME/.claude/settings.json"
-DRIFT_HOOK_CMD="bash $REPO_ROOT/scripts/skill-drift-hook.sh"
-
-status() {
-  echo "agentic-skills checkout: $REPO_ROOT"
-  git -C "$REPO_ROOT" rev-parse --short HEAD 2>/dev/null | sed 's/^/local commit: /' || true
-  git -C "$REPO_ROOT" remote get-url origin 2>/dev/null | sed 's/^/remote URL: /' || echo "remote URL: unavailable"
-
-  if [ -f "$PREFERENCES_FILE" ]; then
-    python3 -c 'import json, pathlib, sys
-path = pathlib.Path(sys.argv[1])
-try:
-    value = json.loads(path.read_text()).get("sync", {}).get("github_freshness_check")
-except Exception:
-    value = None
-print("github freshness preference: " + (value if value in {"ask", "always", "never"} else "unset"))' "$PREFERENCES_FILE"
-  else
-    echo "github freshness preference: unset"
-  fi
-}
-
-doctor() {
-  # shellcheck source=/dev/null
-  source "$REPO_ROOT/scripts/skill-links.sh" || { echo "ERROR: unable to load skill-links.sh" >&2; return 1; }
-  echo "Global skill install drift (~/.claude/skills, ~/.codex/skills):"
-  local found=false any_stale=false target line status rec cur
-  while IFS= read -r target; do
-    [ -n "$target" ] || continue
-    line="$(skill_install_status "$target")"
-    IFS=$'\t' read -r status rec cur <<< "$line"
-    [ "$status" = "not-managed" ] && continue
-    found=true
-    case "$status" in
-      ok)             printf '  ok       %s\n' "$target" ;;
-      pinned)         printf '  pinned   %s (frozen %s)\n' "$target" "${rec:-?}" ;;
-      unknown)        printf '  unknown  %s — rerun init to enable drift tracking\n' "$target" ;;
-      missing-source) printf '  missing  %s — canonical source no longer exists\n' "$target" ;;
-      stale)          printf '  STALE    %s (%s -> %s)\n' "$target" "${rec:-?}" "${cur:-?}"; any_stale=true ;;
-    esac
-  done < <(find "$HOME/.claude/skills" "$HOME/.codex/skills" -mindepth 1 -maxdepth 1 \( -type l -o -type d \) -print 2>/dev/null | sort)
-  $found || echo "  (no managed global skill installs found)"
-  if $any_stale; then
-    echo ""
-    echo "Fix: /init-agentic-skills update  (re-copies global skills from this checkout)"
-    return 1
-  fi
-  return 0
-}
-
-set_pref() {
-  local key="$1" val="$2" jqval
-  case "$key" in
-    session_start_hook|auto_refresh) ;;
-    *) echo "ERROR: unknown preference '$key' (use session_start_hook or auto_refresh)" >&2; return 1 ;;
-  esac
-  case "$val" in
-    true) jqval=true ;;
-    false) jqval=false ;;
-    *) echo "ERROR: value must be true or false" >&2; return 1 ;;
-  esac
-  command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required to set preferences" >&2; return 1; }
-  mkdir -p "$(dirname "$PREFERENCES_FILE")"
-  [ -f "$PREFERENCES_FILE" ] || echo '{}' > "$PREFERENCES_FILE"
-  local tmp
-  tmp="$(jq --arg k "$key" --argjson v "$jqval" '.skills = ((.skills // {}) + {($k): $v})' "$PREFERENCES_FILE")" || { echo "ERROR: jq failed updating $PREFERENCES_FILE" >&2; return 1; }
-  [ -n "$tmp" ] || { echo "ERROR: jq produced empty output for $PREFERENCES_FILE" >&2; return 1; }
-  echo "$tmp" > "$PREFERENCES_FILE"
-  echo "Set skills.$key = $val in $PREFERENCES_FILE"
-}
-
-hook_enable() {
-  command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required to register the hook" >&2; return 1; }
-  mkdir -p "$(dirname "$SETTINGS_FILE")"
-  [ -f "$SETTINGS_FILE" ] || echo '{}' > "$SETTINGS_FILE"
-  local tmp
-  tmp="$(jq --arg cmd "$DRIFT_HOOK_CMD" '
-    .hooks = (.hooks // {})
-    | .hooks.SessionStart = (.hooks.SessionStart // [])
-    | if ([.hooks.SessionStart[]?.hooks[]? | select(.command == $cmd)] | length) > 0
-      then .
-      else .hooks.SessionStart += [ { "hooks": [ { "type": "command", "command": $cmd } ] } ]
-      end
-  ' "$SETTINGS_FILE")" || { echo "ERROR: jq failed updating $SETTINGS_FILE" >&2; return 1; }
-  [ -n "$tmp" ] || { echo "ERROR: jq produced empty output for $SETTINGS_FILE" >&2; return 1; }
-  echo "$tmp" > "$SETTINGS_FILE"
-  set_pref session_start_hook true
-  echo "Registered SessionStart drift hook in $SETTINGS_FILE"
-}
-
-hook_disable() {
-  set_pref session_start_hook false
-  command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required to remove the hook" >&2; return 1; }
-  [ -f "$SETTINGS_FILE" ] || { echo "No $SETTINGS_FILE; nothing to remove."; return 0; }
-  local tmp
-  tmp="$(jq --arg cmd "$DRIFT_HOOK_CMD" '
-    if .hooks.SessionStart then
-      .hooks.SessionStart = ([ .hooks.SessionStart[]
-        | .hooks = ([ .hooks[]? | select(.command != $cmd) ])
-        | select((.hooks | length) > 0) ])
-      | if (.hooks.SessionStart | length) == 0 then del(.hooks.SessionStart) else . end
-      | if (.hooks | length) == 0 then del(.hooks) else . end
-    else . end
-  ' "$SETTINGS_FILE")" || { echo "ERROR: jq failed updating $SETTINGS_FILE" >&2; return 1; }
-  [ -n "$tmp" ] || { echo "ERROR: jq produced empty output for $SETTINGS_FILE" >&2; return 1; }
-  echo "$tmp" > "$SETTINGS_FILE"
-  echo "Removed SessionStart drift hook from $SETTINGS_FILE"
-}
-
-show_prefs() {
-  if [ -f "$PREFERENCES_FILE" ] && command -v jq >/dev/null 2>&1; then
-    echo "session_start_hook: $(jq -r '.skills.session_start_hook // false' "$PREFERENCES_FILE")"
-    echo "auto_refresh:       $(jq -r '.skills.auto_refresh // false' "$PREFERENCES_FILE")"
-  else
-    echo "session_start_hook: false"
-    echo "auto_refresh:       false"
-  fi
-}
-
-confirm_update() {
-  if [ "${1:-}" = "--yes" ] || [ "${1:-}" = "-y" ]; then
-    return 0
-  fi
-  printf "Check GitHub, fast-forward this checkout if possible, and rerun init.sh? [y/N] "
-  read -r reply
-  case "$reply" in
-    y|Y|yes|YES) return 0 ;;
-    *) echo "Update cancelled."; return 1 ;;
-  esac
-}
-
-update_latest() {
-  confirm_update "${1:-}"
-  git -C "$REPO_ROOT" fetch origin
-  git -C "$REPO_ROOT" rev-parse --short HEAD | sed 's/^/local before: /'
-  git -C "$REPO_ROOT" rev-parse --short origin/HEAD | sed 's/^/origin HEAD: /'
-  git -C "$REPO_ROOT" merge --ff-only origin/HEAD
-  bash "$REPO_ROOT/$DELEGATE_SCRIPT"
-  echo "Refresh complete."
-  echo "Claude Code: run /reload-skills first; /clear starts a new empty-context conversation and can pick up the refreshed registry. Restart Claude Code if the top-level .claude/skills directory did not exist at session start or the skill is still invisible."
-  echo 'Codex: start a fresh Codex CLI session if the $ skill list remains stale.'
-}
-
-case "${1:-}" in
-  status)
-    status
-    ;;
-  doctor)
-    doctor
-    ;;
-  update|latest)
-    mode="$1"
-    shift
-    update_latest "${1:-}"
-    ;;
-  set-pref)
-    shift
-    set_pref "${1:-}" "${2:-}"
-    ;;
-  show-prefs)
-    show_prefs
-    ;;
-  hook)
-    shift
-    case "${1:-}" in
-      enable) hook_enable ;;
-      disable) hook_disable ;;
-      *) echo "Usage: init-agentic-skills.sh hook <enable|disable>" >&2; exit 2 ;;
-    esac
-    ;;
-  *)
-    exec bash "$REPO_ROOT/$DELEGATE_SCRIPT" "$@"
-    ;;
-esac