feat: add Antigravity CLI support, --list flag, and skill descriptions

- Replace Gemini CLI with Antigravity CLI throughout (--gemini kept as hidden fallback flag; GEMINI_SKILLS_DIR honoured as legacy env var) - Default install dir updated to ~/.gemini/antigravity-cli/skills - Add ANTIGRAVITY_SKILLS_DIR env var with GEMINI_SKILLS_DIR fallback - Add -l/--list flag: lists available skills with one-line descriptions - Add descriptions.json mapping skill names to short descriptions; fetch_descriptions() prefers a local copy when running from a clone, falls back to remote URL for curl-pipe installs - Document ship-it skill in README (was missing since its addition) - Fix Manual Install cd path: claude-skills → ai-skills
2026-05-31 21:15:30 -04:00
parent cd17b074dd
commit 11a02b74a0
3 changed files with 125 additions and 41 deletions
@@ -1,6 +1,6 @@
 # Rootiest Skills Repository

-A collection of reusable AI skills (structured prompt protocols) for **Claude Code** and **Gemini CLI**. Each skill defines a precise execution protocol that guides the AI through complex, multi-step tasks — replacing ad-hoc prompting with consistent, auditable workflows.
+A collection of reusable AI skills (structured prompt protocols) for **Claude Code** and **Antigravity CLI**. Each skill defines a precise execution protocol that guides the AI through complex, multi-step tasks — replacing ad-hoc prompting with consistent, auditable workflows.

 Skills are plain Markdown files. The included `install.sh` script handles discovery and installation in a single command.

@@ -12,6 +12,7 @@ Skills are plain Markdown files. The included `install.sh` script handles discov
  - [systematic-enumeration](#systematic-enumeration)
  - [git-publish-workflow](#git-publish-workflow)
  - [readme-sync-audit](#readme-sync-audit)
+  - [ship-it](#ship-it)
 - [Installation](#installation)
  - [Quick Install (curl)](#quick-install-curl)
  - [Flags & Options](#flags--options)
@@ -66,6 +67,19 @@ Three-phase execution:

 ---

+### `ship-it`
+
+**Purpose:** Run a comprehensive pre-flight audit and publish changes to a new PR in a single command.
+
+Two sequential phases — Phase 2 is blocked until Phase 1 succeeds:
+
+1. **Documentation Sync & Code Audit** — acts as `/readme-sync-audit`: scans all file changes since the last README edit, updates the README to match the current codebase, and audits code files for syntax errors or regressions. **Halts the entire workflow** if any breaking issue is found.
+2. **Git Publish Workflow** — acts as `/git-publish-workflow`: creates a descriptively named branch, commits all pending changes (including the README updates from Phase 1), pushes to the remote, and opens a Pull Request against `main`.
+
+**Use when:** you say "Ship this," "Publish my changes," or invoke `/ship-it`.
+
+---
+
 ## Installation

 ### Quick Install (curl)
@@ -76,7 +90,7 @@ The intended usage is a single `curl | bash` command. The installer fetches and
 > The short-url `https://url.rootiest.dev/skills` can be substituted for the full URL in the examples below.  
 > e.g. `curl -sL https://url.rootiest.dev/skills | bash -s -- --all`

-**Install all skills for both Claude Code and Gemini CLI:**
+**Install all skills for both Claude Code and Antigravity CLI:**

 ```bash
 curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all
@@ -88,10 +102,10 @@ curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh
 curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all --claude
 ```

-**Install all skills for Gemini CLI only:**
+**Install all skills for Antigravity CLI only:**

 ```bash
-curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all --gemini
+curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all --antigravity
 ```

 **Install a single skill for both tools:**
@@ -106,10 +120,10 @@ curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh
 curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --claude git-publish-workflow readme-sync-audit
 ```

-**Install specific skills for Gemini CLI only:**
+**Install specific skills for Antigravity CLI only:**

 ```bash
-curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --gemini systematic-enumeration git-publish-workflow
+curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --antigravity systematic-enumeration git-publish-workflow
 ```

 > **Note:** Providing explicit skill names alongside `--all` causes the named skills to take precedence — only those skills are installed.
@@ -121,12 +135,13 @@ curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh
 | Flag | Description |
 |---|---|
 | `-c`, `--claude` | Install into Claude Code (`~/.claude/skills/`) |
-| `-g`, `--gemini` | Install into Gemini CLI (`~/.gemini/skills/`) |
+| `-g`, `--antigravity` | Install into Antigravity CLI (`~/.gemini/antigravity-cli/skills/`) |
 | `-a`, `--all` | Install every skill available in the repository |
 | `SKILL...` | Install one or more named skills (positional arguments) |
+| `-l`, `--list` | List all available skills with descriptions and exit |
 | `-h`, `--help` | Show the help page |

-**Tool targeting:** if neither `--claude` nor `--gemini` is specified, the installer targets **both** tools by default.
+**Tool targeting:** if neither `--claude` nor `--antigravity` is specified, the installer targets **both** tools by default.

 **Skill selection precedence:** explicit skill names always override `--all`. Passing `--all skill-name` installs only `skill-name`, not every skill.

@@ -139,7 +154,7 @@ curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh
 | Variable | Default | Description |
 |---|---|---|
 | `CLAUDE_SKILLS_DIR` | `~/.claude/skills` | Override the Claude Code install directory |
-| `GEMINI_SKILLS_DIR` | `~/.gemini/skills` | Override the Gemini CLI install directory |
+| `ANTIGRAVITY_SKILLS_DIR` | `~/.gemini/antigravity-cli/skills` | Override the Antigravity CLI install directory. Falls back to `GEMINI_SKILLS_DIR` if set (legacy support). |

 Example — installing to a project-local skills directory:

@@ -159,8 +174,8 @@ curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh
 # Install one skill, Claude only
 curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --claude git-publish-workflow

-# Install two skills, Gemini only
-curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --gemini systematic-enumeration readme-sync-audit
+# Install two skills, Antigravity only
+curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --antigravity systematic-enumeration readme-sync-audit

 # Override install directory, Claude only
 curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh \
@@ -188,7 +203,7 @@ Or clone the repository and run locally:

 ```bash
 git clone https://git.rootiest.dev/rootiest/ai-skills.git
-cd claude-skills
+cd ai-skills
 bash install.sh --all
 ```

@@ -0,0 +1,6 @@
+{
+  "git-publish-workflow": "Automate the full lifecycle from uncommitted local work to an open Pull Request, with built-in quality gates.",
+  "readme-sync-audit": "Keep README.md accurate by programmatically aligning it with the current state of the codebase.",
+  "ship-it": "Run a comprehensive pre-flight audit and publish changes to a new PR in a single command.",
+  "systematic-enumeration": "Eliminate counting and membership errors via explicit set enumeration and atomic element testing."
+}
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # install.sh — AI Skill Installer
-# Install skills from rootiest/ai-skills into Claude Code and/or Gemini CLI
+# Install skills from rootiest/ai-skills into Claude Code and/or Antigravity CLI
 #
 # Usage: bash <(curl -sL <url>) [OPTIONS] [SKILL...]

@@ -13,7 +13,8 @@ readonly API_URL="https://git.rootiest.dev/api/v1/repos/rootiest/ai-skills/conte

 # Overridable via environment
 CLAUDE_SKILLS_DIR="${CLAUDE_SKILLS_DIR:-${HOME}/.claude/skills}"
-GEMINI_SKILLS_DIR="${GEMINI_SKILLS_DIR:-${HOME}/.gemini/skills}"
+# ANTIGRAVITY_SKILLS_DIR takes precedence; fall back to GEMINI_SKILLS_DIR for legacy support
+ANTIGRAVITY_SKILLS_DIR="${ANTIGRAVITY_SKILLS_DIR:-${GEMINI_SKILLS_DIR:-${HOME}/.gemini/antigravity-cli/skills}}"

 # ── ANSI Colors (only when writing to a terminal) ─────────────────────────────
 if [[ -t 1 ]]; then
@@ -31,9 +32,11 @@ fi

 # ── State ─────────────────────────────────────────────────────────────────────
 INSTALL_CLAUDE=false
-INSTALL_GEMINI=false
+INSTALL_ANTIGRAVITY=false
 INSTALL_ALL=false
+LIST_SKILLS=false
 declare -a SKILLS=()
+DESCRIPTIONS_JSON=""
 TMP_DIR=""

 # ── Cleanup ───────────────────────────────────────────────────────────────────
@@ -55,16 +58,16 @@ sep()     { printf "${BOLD_CYAN}%s${RESET}\n" "───────────
 show_help() {
  printf "\n"
  printf "${BOLD_CYAN}  AI Skill Installer${RESET}\n"
-  printf "${DIM}  Install skills from rootiest/ai-skills into Claude Code and Gemini CLI${RESET}\n"
+  printf "${DIM}  Install skills from rootiest/ai-skills into Claude Code and Antigravity CLI${RESET}\n"
  printf "\n"
  printf "${BOLD}  USAGE${RESET}\n"
  printf "    install.sh [OPTIONS] [SKILL...]\n"
  printf "    bash <(curl -sL <url>/install.sh) [OPTIONS] [SKILL...]\n"
  printf "\n"
  printf "${BOLD}  TOOL TARGETS${RESET}\n"
-  printf "    ${GREEN}-c, --claude${RESET}    Install into Claude Code  (\$CLAUDE_SKILLS_DIR)\n"
-  printf "    ${GREEN}-g, --gemini${RESET}    Install into Gemini CLI   (\$GEMINI_SKILLS_DIR)\n"
-  printf "    ${DIM}                (default: install for both tools)${RESET}\n"
+  printf "    ${GREEN}-c, --claude${RESET}        Install into Claude Code      (\$CLAUDE_SKILLS_DIR)\n"
+  printf "    ${GREEN}-g, --antigravity${RESET}   Install into Antigravity CLI  (\$ANTIGRAVITY_SKILLS_DIR)\n"
+  printf "    ${DIM}                    (default: install for both tools)${RESET}\n"
  printf "\n"
  printf "${BOLD}  SKILL SELECTION${RESET}\n"
  printf "    ${GREEN}-a, --all${RESET}       Install every skill in the repository\n"
@@ -72,6 +75,7 @@ show_help() {
  printf "    ${DIM}                Specific names always override --all${RESET}\n"
  printf "\n"
  printf "${BOLD}  OTHER${RESET}\n"
+  printf "    ${GREEN}-l, --list${RESET}      List all available skills and exit\n"
  printf "    ${GREEN}-h, --help${RESET}      Show this help page\n"
  printf "\n"
  printf "${BOLD}  EXAMPLES${RESET}\n"
@@ -81,15 +85,16 @@ show_help() {
  printf "    ${DIM}# Install one skill, Claude Code only${RESET}\n"
  printf "    install.sh --claude my-skill\n"
  printf "\n"
-  printf "    ${DIM}# Install two skills, Gemini CLI only${RESET}\n"
-  printf "    install.sh --gemini skill-one skill-two\n"
+  printf "    ${DIM}# Install two skills, Antigravity CLI only${RESET}\n"
+  printf "    install.sh --antigravity skill-one skill-two\n"
  printf "\n"
  printf "    ${DIM}# Named skills override --all (only those listed are installed)${RESET}\n"
  printf "    install.sh --all --claude skill-name\n"
  printf "\n"
  printf "${BOLD}  ENVIRONMENT${RESET}\n"
-  printf "    ${GREEN}CLAUDE_SKILLS_DIR${RESET}   Claude skills directory  (default: ~/.claude/skills)\n"
-  printf "    ${GREEN}GEMINI_SKILLS_DIR${RESET}   Gemini skills directory  (default: ~/.gemini/skills)\n"
+  printf "    ${GREEN}CLAUDE_SKILLS_DIR${RESET}        Claude skills directory      (default: ~/.claude/skills)\n"
+  printf "    ${GREEN}ANTIGRAVITY_SKILLS_DIR${RESET}   Antigravity skills directory (default: ~/.gemini/antigravity-cli/skills)\n"
+  printf "    ${DIM}                         Falls back to GEMINI_SKILLS_DIR if set (legacy support)${RESET}\n"
  printf "\n"
  printf "${BOLD}  REPOSITORY${RESET}\n"
  printf "    ${DIM}%s${RESET}\n" "$REPO_URL"
@@ -178,6 +183,61 @@ discover_skills() {
  ok "Found ${#SKILLS[@]} skill(s): ${DIM}${SKILLS[*]}${RESET}"
 }

+# ── Fetch & Query Skill Descriptions ─────────────────────────────────────────
+fetch_descriptions() {
+  # Prefer a local descriptions.json when running from a clone
+  local script_dir
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" 2>/dev/null && pwd)" || script_dir=""
+  if [[ -n "$script_dir" && -f "${script_dir}/descriptions.json" ]]; then
+    DESCRIPTIONS_JSON=$(<"${script_dir}/descriptions.json")
+    return
+  fi
+
+  local url="${BASE_URL}/descriptions.json"
+  DESCRIPTIONS_JSON=$(curl -sf --max-time 10 "$url" 2>/dev/null) || DESCRIPTIONS_JSON=""
+}
+
+get_description() {
+  local skill_name="$1"
+  if [[ -z "$DESCRIPTIONS_JSON" ]]; then return; fi
+
+  if command -v jq &>/dev/null; then
+    printf '%s' "$DESCRIPTIONS_JSON" | jq -r --arg n "$skill_name" '.[$n] // empty'
+    return
+  fi
+
+  if command -v python3 &>/dev/null; then
+    printf '%s' "$DESCRIPTIONS_JSON" | python3 -c \
+      "import sys,json; d=json.load(sys.stdin); print(d.get('${skill_name}',''))"
+    return
+  fi
+
+  # awk fallback: relies on pretty-printed JSON with one key per line
+  printf '%s' "$DESCRIPTIONS_JSON" | awk -F'"' -v key="$skill_name" '$2 == key { print $4 }'
+}
+
+# ── List Available Skills ─────────────────────────────────────────────────────
+list_skills() {
+  check_deps
+  discover_skills
+  fetch_descriptions
+  printf "\n"
+  sep
+  printf "  ${BOLD}Available skills${RESET}\n"
+  sep
+  printf "\n"
+  for skill in "${SKILLS[@]}"; do
+    local desc
+    desc=$(get_description "$skill")
+    if [[ -n "$desc" ]]; then
+      printf "  ${GREEN}•${RESET}  ${BOLD}%s${RESET}\n     ${DIM}%s${RESET}\n\n" "$skill" "$desc"
+    else
+      printf "  ${GREEN}•${RESET}  %s\n" "$skill"
+    fi
+  done
+  printf "\n"
+}
+
 # ── Fetch a Single Skill's SKILL.md ──────────────────────────────────────────
 fetch_skill() {
  local skill_name="$1"
@@ -206,22 +266,22 @@ install_to_claude() {
  ok "[Claude] ${BOLD}${skill_name}${RESET} → ${DIM}${dest}${RESET}"
 }

-# ── Install to Gemini CLI ─────────────────────────────────────────────────────
-install_to_gemini() {
+# ── Install to Antigravity CLI ────────────────────────────────────────────────
+install_to_antigravity() {
  local skill_name="$1"
-  local dest="${GEMINI_SKILLS_DIR}/${skill_name}/SKILL.md"
+  local dest="${ANTIGRAVITY_SKILLS_DIR}/${skill_name}/SKILL.md"

-  info "[Gemini] Downloading ${BOLD}${skill_name}${RESET}..."
+  info "[Antigravity] Downloading ${BOLD}${skill_name}${RESET}..."

  local content
  if ! content=$(fetch_skill "$skill_name"); then
-    warn "[Gemini] Skipping '${skill_name}' — download failed."
+    warn "[Antigravity] Skipping '${skill_name}' — download failed."
    return 1
  fi

-  mkdir -p "${GEMINI_SKILLS_DIR}/${skill_name}"
+  mkdir -p "${ANTIGRAVITY_SKILLS_DIR}/${skill_name}"
  printf '%s\n' "$content" > "$dest"
-  ok "[Gemini] ${BOLD}${skill_name}${RESET} → ${DIM}${dest}${RESET}"
+  ok "[Antigravity] ${BOLD}${skill_name}${RESET} → ${DIM}${dest}${RESET}"
 }

 # ── Main ──────────────────────────────────────────────────────────────────────
@@ -233,20 +293,23 @@ main() {
  # ── Parse Arguments ────────────────────────────────────────────────────────
  while [[ $# -gt 0 ]]; do
    case "$1" in
-      -h|--help)   show_help; exit 0 ;;
-      -c|--claude) INSTALL_CLAUDE=true ;;
-      -g|--gemini) INSTALL_GEMINI=true ;;
-      -a|--all)    INSTALL_ALL=true ;;
+      -h|--help)            show_help; exit 0 ;;
+      -l|--list)            LIST_SKILLS=true ;;
+      -c|--claude)          INSTALL_CLAUDE=true ;;
+      -g|--antigravity|--gemini) INSTALL_ANTIGRAVITY=true ;;
+      -a|--all)             INSTALL_ALL=true ;;
      -*)          die "Unknown option: '${1}'. Run with -h for help." ;;
      *)           positional+=("$1") ;;
    esac
    shift
  done

+  if $LIST_SKILLS; then list_skills; exit 0; fi
+
  # Default: install for both tools when neither is specified
-  if ! $INSTALL_CLAUDE && ! $INSTALL_GEMINI; then
+  if ! $INSTALL_CLAUDE && ! $INSTALL_ANTIGRAVITY; then
    INSTALL_CLAUDE=true
-    INSTALL_GEMINI=true
+    INSTALL_ANTIGRAVITY=true
  fi

  check_deps
@@ -269,12 +332,12 @@ main() {

  # ── Target Label for Display ──────────────────────────────────────────────
  local target_label
-  if $INSTALL_CLAUDE && $INSTALL_GEMINI; then
-    target_label="Claude Code + Gemini CLI"
+  if $INSTALL_CLAUDE && $INSTALL_ANTIGRAVITY; then
+    target_label="Claude Code + Antigravity CLI"
  elif $INSTALL_CLAUDE; then
    target_label="Claude Code"
  else
-    target_label="Gemini CLI"
+    target_label="Antigravity CLI"
  fi

  # ── Header ────────────────────────────────────────────────────────────────
@@ -291,8 +354,8 @@ main() {
    if $INSTALL_CLAUDE; then
      install_to_claude "$skill" || errors=$((errors + 1))
    fi
-    if $INSTALL_GEMINI; then
-      install_to_gemini "$skill" || errors=$((errors + 1))
+    if $INSTALL_ANTIGRAVITY; then
+      install_to_antigravity "$skill" || errors=$((errors + 1))
    fi
    printf "\n"
  done