Skip to content

IvanCampos/agents / skills/apple-notes

apple-notes

Flagged

Read Apple Notes content and execute checklist-driven automations in order. Use when a user asks to run tasks from an Apple Note (especially a checklist note like "AGENT TODO LIST"), or to fetch a specific note body for automation.

FileKindSize
SKILL.mdskill md3.1 KB
agents/openai.yamlconfig201 B
scripts/dispatch_skill_item.shexecutablescript20.0 KB
scripts/manage_notes.applescriptother8.9 KB
scripts/manage_notes.shexecutablescript8.1 KB
scripts/run_checklist_note.shexecutablescript5.8 KB

scripts/dispatch_skill_item.sh

View on GitHub
#!/usr/bin/env bash
set -euo pipefail

NOTE_TITLE=""
ITEM_TEXT=""
NORMALIZED_INPUT=""

while [[ $# -gt 0 ]]; do
  case "$1" in
    --note-title)
      NOTE_TITLE="${2:-}"
      shift 2
      ;;
    --item)
      ITEM_TEXT="${2:-}"
      shift 2
      ;;
    --normalized)
      NORMALIZED_INPUT="${2:-}"
      shift 2
      ;;
    *)
      echo "Unknown arg: $1" >&2
      exit 2
      ;;
  esac
done

if [[ -z "$NOTE_TITLE" || -z "$ITEM_TEXT" ]]; then
  echo "Missing required args: --note-title and --item" >&2
  exit 2
fi

SKILLS_ROOT="/Users/ivancampos/.codex/skills"
CONFETTI_SCRIPT="$SKILLS_ROOT/confetti/scripts/run_confetti.sh"
APPLE_NOTES_SCRIPT="$SKILLS_ROOT/apple-notes/scripts/run_checklist_note.sh"
APPLE_NOTES_MANAGE_SCRIPT="$SKILLS_ROOT/apple-notes/scripts/manage_notes.sh"
GIT_SEARCH_SCRIPT="$SKILLS_ROOT/git-search/scripts/list_commits.sh"
LAUNCHD_SHOW_SCRIPT="$SKILLS_ROOT/launchd-non-apple-jobs/scripts/show_jobs.sh"
LAUNCHD_CREATE_SCRIPT="$SKILLS_ROOT/launchd-non-apple-jobs/scripts/create_job.sh"
LAUNCHD_DELETE_SCRIPT="$SKILLS_ROOT/launchd-non-apple-jobs/scripts/delete_job.sh"
MAILAPP_SCRIPT="$SKILLS_ROOT/mailapp-send-email/scripts/send_mail.applescript"
OPEN_METEO_SCRIPT="$SKILLS_ROOT/open-meteo-weather/scripts/open_meteo_current.py"
OPML_READER_SCRIPT="$SKILLS_ROOT/opml-reader/scripts/opml_reader.py"
PLAYWRIGHT_WRAPPER="$SKILLS_ROOT/playwright/scripts/playwright_cli.sh"
SCREEN_RECORDER_SCRIPT="$SKILLS_ROOT/screen-recorder/scripts/record_screen.sh"
APPLE_MUSIC_SCRIPT="$SKILLS_ROOT/apple-music-player/scripts/play_random_music.sh"
OPEN_APP_SCRIPT="$SKILLS_ROOT/applescript-open-app/scripts/open_app.sh"
QUIT_APP_SCRIPT="$SKILLS_ROOT/applescript-open-app/scripts/quit_app.sh"
VTD_SCRIPT="$SKILLS_ROOT/video-transcript-downloader/scripts/vtd.js"
YOUTUBE_SCRIPT="$SKILLS_ROOT/youtube-data-api/youtube-data-api-1.0.0/scripts/youtube.py"
SKILL_CREATOR_INIT_SCRIPT="$SKILLS_ROOT/.system/skill-creator/scripts/init_skill.py"
SKILL_CREATOR_VALIDATE_SCRIPT="$SKILLS_ROOT/.system/skill-creator/scripts/quick_validate.py"
SKILL_CREATOR_YAML_SCRIPT="$SKILLS_ROOT/.system/skill-creator/scripts/generate_openai_yaml.py"
SKILL_INSTALLER_LIST_SCRIPT="$SKILLS_ROOT/.system/skill-installer/scripts/list-skills.py"
SKILL_INSTALLER_INSTALL_SCRIPT="$SKILLS_ROOT/.system/skill-installer/scripts/install-skill-from-github.py"

normalize_skill_name() {
  local raw="$1"
  printf '%s' "$raw" \
    | tr '[:upper:]' '[:lower:]' \
    | sed -E 's/[[:space:]_]+/-/g; s/[^a-z0-9.-]+/-/g; s/-+/-/g; s/^-+//; s/-+$//'
}

run_shell_with_prefix() {
  local prefix="$1"
  local args="${2:-}"
  local cmd="$prefix"

  if [[ -n "$args" ]]; then
    cmd+=" $args"
  fi

  bash -lc "$cmd"
}

run_codex_skill() {
  local skill_name="$1"
  local request="${2:-}"

  if ! command -v codex >/dev/null 2>&1; then
    echo "codex CLI not found; cannot run skill fallback for: $skill_name" >&2
    return 1
  fi

  local prompt
  if [[ -n "$request" ]]; then
    prompt="Use the \"$skill_name\" skill and execute this request: $request"
  else
    prompt="Use the \"$skill_name\" skill and execute a sensible default action."
  fi

  local out_file
  out_file="$(mktemp)"
  if codex exec --skip-git-repo-check -o "$out_file" "$prompt" >/dev/null 2>&1; then
    if [[ -s "$out_file" ]]; then
      sed 's/^/    /' "$out_file"
    fi
    rm -f "$out_file"
    return 0
  fi

  rm -f "$out_file"
  return 1
}

run_say_skill() {
  local say_text="$1"
  echo "- Say: $say_text"
  say -v Alex "$say_text"
}

run_playwright_command() {
  local skill_args="${1:-}"
  if [[ -z "$skill_args" ]]; then
    echo "playwright requires args. Example: playwright: open https://example.com" >&2
    return 1
  fi

  if [[ -x "$PLAYWRIGHT_WRAPPER" ]] && run_shell_with_prefix "$PLAYWRIGHT_WRAPPER" "$skill_args"; then
    return 0
  fi

  if command -v playwright >/dev/null 2>&1; then
    run_shell_with_prefix "playwright" "$skill_args"
    return 0
  fi

  run_shell_with_prefix "npx --yes playwright" "$skill_args"
}

dispatch_natural_language_item() {
  local item_text="$1"
  local normalized_item="$2"
  local trimmed_item
  trimmed_item="$(printf '%s' "$item_text" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"

  if [[ "$trimmed_item" =~ ^[Pp]lay[[:space:]]+a[[:space:]]+random[[:space:]]+song[[:space:]]+by[[:space:]]+(.+)$ ]]; then
    local artist="${BASH_REMATCH[1]}"
    echo "- Apple Music Random Song (artist: $artist)"
    "$APPLE_MUSIC_SCRIPT" --artist "$artist"
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Pp]lay[[:space:]]+song[[:space:]]+(.+)[[:space:]]+by[[:space:]]+(.+)$ ]]; then
    local track="${BASH_REMATCH[1]}"
    local artist="${BASH_REMATCH[2]}"
    echo "- Apple Music Track (track: $track, artist: $artist)"
    "$APPLE_MUSIC_SCRIPT" --track "$track" --artist "$artist"
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Pp]lay[[:space:]]+(.+)[[:space:]]+by[[:space:]]+(.+)([[:space:]]+on[[:space:]]+[Aa]pple[[:space:]]+[Mm]usic)?$ ]]; then
    local track="${BASH_REMATCH[1]}"
    local artist="${BASH_REMATCH[2]}"
    artist="$(printf '%s' "$artist" | sed -E 's/[[:space:]]+on[[:space:]]+[Aa]pple[[:space:]]+[Mm]usic$//I')"
    echo "- Apple Music Track (track: $track, artist: $artist)"
    "$APPLE_MUSIC_SCRIPT" --track "$track" --artist "$artist"
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Uu]se[[:space:]]+say[[:space:]]+to[[:space:]]+tell[[:space:]]+me[[:space:]]+the[[:space:]]+current[[:space:]]+weather[[:space:]]+in[[:space:]]+(.+)$ ]]; then
    local location="${BASH_REMATCH[1]}"
    local weather_json
    weather_json="$(python3 "$OPEN_METEO_SCRIPT" --location "$location")"
    local spoken
    spoken="$(
      python3 -c 'import json,sys
d=json.loads(sys.stdin.read())
loc=d.get("location",{})
cw=d.get("current_weather",{})
name=loc.get("name") or "your location"
tf=cw.get("temperature_f")
tc=cw.get("temperature_c")
wind=cw.get("windspeed_kmh")
if tf is not None and tc is not None:
    msg=f"Current weather in {name}: {round(tf)} degrees Fahrenheit ({round(tc)} Celsius), wind speed {round(wind)} kilometers per hour."
elif tf is not None:
    msg=f"Current weather in {name}: {round(tf)} degrees Fahrenheit."
elif tc is not None:
    msg=f"Current weather in {name}: {round(tc)} degrees Celsius."
else:
    msg=f"Current weather in {name} is unavailable."
print(msg)' <<< "$weather_json"
    )"
    run_say_skill "$spoken"
    return 0
  fi

  if [[ "$normalized_item" =~ ^(open|navigate|go[[:space:]]+to|use[[:space:]]+playwright[[:space:]]+to[[:space:]]+open)[[:space:]]+.+$ ]]; then
    local target="$trimmed_item"
    target="$(printf '%s' "$target" | sed -E 's/^(open|navigate|go to|use playwright to open)[[:space:]]+//I')"
    target="$(printf '%s' "$target" | sed -E 's/[[:space:]]+in[[:space:]]+the[[:space:]]+browser$//I; s/[[:space:]]+with[[:space:]]+playwright$//I')"
    target="$(printf '%s' "$target" | sed -E 's/[[:space:]]+$//')"

    if [[ "$target" =~ ^https?:// ]]; then
      echo "- Open URL"
      open "$target"
      return 0
    fi

    local domain_candidate
    domain_candidate="$(printf '%s\n' "$target" | rg -oim1 '([a-z0-9-]+\.)+[a-z]{2,}(/[^\ ]*)?' || true)"
    if [[ -n "$domain_candidate" ]]; then
      echo "- Open URL"
      open "https://$domain_candidate"
      return 0
    fi

    if [[ "$target" =~ [[:space:]]+on[[:space:]]+([a-z0-9-]+)(\.[a-z]{2,})?$ ]]; then
      local host="${BASH_REMATCH[1]}"
      local tld="${BASH_REMATCH[2]}"
      if [[ -z "$tld" ]]; then
        tld=".com"
      fi
      echo "- Open URL"
      open "https://${host}${tld}"
      return 0
    fi
  fi

  if [[ "$trimmed_item" =~ ^[Ss]top[[:space:]]+[Aa]pple[[:space:]]+[Mm]usic$ ]]; then
    echo "- Stop Apple Music"
    osascript -e 'tell application "Music" to stop'
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Ss]how[[:space:]]+me[[:space:]]+(.+)[[:space:]]+on[[:space:]]+[Yy]ou[Tt]ube([[:space:]]+and[[:space:]]+play([[:space:]]+the)?[[:space:]]+video)?$ ]]; then
    local query="${BASH_REMATCH[1]}"
    local query_normalized
    query_normalized="$(printf '%s' "$query" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/ /g; s/[[:space:]]+/ /g; s/^ //; s/ $//')"

    if [[ "$query_normalized" == *"andrej karpathy yc startup school"* ]]; then
      echo "- Open YouTube Video"
      open "https://www.youtube.com/watch?v=LCEmiRjPEtQ"
      return 0
    fi

    local encoded
    encoded="$(python3 -c 'import sys, urllib.parse; print(urllib.parse.quote_plus(sys.argv[1]))' "$query")"
    echo "- Open YouTube Search"
    open "https://www.youtube.com/results?search_query=${encoded}"
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Ss]ay[[:space:]]+the[[:space:]]+price[[:space:]]+of[[:space:]]+[Bb]itcoin$ ]]; then
    local btc
    btc="$(curl -fsSL "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd" | python3 -c 'import json,sys; print(json.load(sys.stdin)["bitcoin"]["usd"])')"
    run_say_skill "Bitcoin is ${btc} dollars."
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Aa]dd[[:space:]]+text[[:space:]]+to[[:space:]]+the[[:space:]]+bottom[[:space:]]+of[[:space:]]+.+[Nn]ote[[:space:]]+in[[:space:]]+[Aa]pple[[:space:]]+[Nn]otes[[:space:]]+that[[:space:]]+says[[:space:]]+[“\"](.+)[”\"]$ ]]; then
    local line_text="${BASH_REMATCH[1]}"
    local current_body
    current_body="$("$APPLE_NOTES_MANAGE_SCRIPT" read --title "$NOTE_TITLE" --format body | sed -n '/^----$/,$p' | tail -n +2)"
    if ! printf '%s' "$current_body" | rg -q "<div>${line_text}</div>"; then
      local new_body="${current_body}<div>${line_text}</div>"
      "$APPLE_NOTES_MANAGE_SCRIPT" update --title "$NOTE_TITLE" --body "$new_body" >/dev/null
    fi
    echo "- Appended text to note: $line_text"
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Oo]pen[[:space:]]+([A-Za-z0-9 .+_-]+)$ ]]; then
    local app_name="${BASH_REMATCH[1]}"
    if [[ -x "$OPEN_APP_SCRIPT" ]]; then
      echo "- Open App ($app_name)"
      "$OPEN_APP_SCRIPT" "$app_name"
      return 0
    fi
  fi

  if [[ "$trimmed_item" =~ ^[Qq]uit[[:space:]]+([A-Za-z0-9 .+_-]+)$ ]]; then
    local app_name="${BASH_REMATCH[1]}"
    if [[ -x "$QUIT_APP_SCRIPT" ]]; then
      echo "- Quit App ($app_name)"
      "$QUIT_APP_SCRIPT" "$app_name"
      return 0
    fi
  fi

  return 2
}

dispatch_skill_item() {
  local note_title="$1"
  local item_text="$2"
  local normalized_item="$3"
  local trimmed_item
  trimmed_item="$(printf '%s' "$item_text" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"

  if [[ "$trimmed_item" =~ ^[Ss]ay[[:space:]]+the[[:space:]]+price[[:space:]]+of[[:space:]]+[Bb]itcoin$ ]]; then
    local btc
    btc="$(curl -fsSL "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd" | python3 -c 'import json,sys; print(json.load(sys.stdin)["bitcoin"]["usd"])')"
    run_say_skill "Bitcoin is ${btc} dollars."
    return 0
  fi

  if [[ "$trimmed_item" =~ ^[Ss][Aa][Yy][[:space:]]+(.+) ]]; then
    local say_text="${BASH_REMATCH[1]}"
    run_say_skill "$say_text"
    return 0
  fi

  if [[ "$normalized_item" == "confetti" ]]; then
    echo "- Confetti"
    "$CONFETTI_SCRIPT"
    return 0
  fi

  if [[ "$normalized_item" =~ ^record[[:space:]]+(my[[:space:]]+)?screen[[:space:]]+for[[:space:]]+([0-9]+)[[:space:]]+seconds?$ ]]; then
    local seconds="${BASH_REMATCH[2]}"
    echo "- Screen Recorder (${seconds}s)"
    "$SCREEN_RECORDER_SCRIPT" --seconds "$seconds"
    return 0
  fi

  if [[ "$trimmed_item" =~ ^([^:]+):[[:space:]]*(.*)$ ]]; then
    local skill_label="${BASH_REMATCH[1]}"
    local skill_args="${BASH_REMATCH[2]}"
    local skill_key
    skill_key="$(normalize_skill_name "$skill_label")"

    local first_word="${skill_args%% *}"
    local rest="${skill_args#"$first_word"}"
    rest="${rest# }"

    case "$skill_key" in
      apple-notes)
        case "$first_word" in
          create|read|update|delete|search|list|help|-h|--help)
            echo "- Apple Notes ($first_word)"
            run_shell_with_prefix "$APPLE_NOTES_MANAGE_SCRIPT" "$skill_args"
            ;;
          checklist|run-checklist)
            local target_note="$rest"
            if [[ -z "$target_note" ]]; then
              target_note="$note_title"
            fi
            if [[ "$target_note" == "$note_title" ]]; then
              echo "Refusing recursive apple-notes checklist call on active note: $note_title" >&2
              return 1
            fi
            echo "- Apple Notes Checklist: $target_note"
            "$APPLE_NOTES_SCRIPT" "$target_note"
            ;;
          *)
            local target_note="$skill_args"
            if [[ -z "$target_note" ]]; then
              target_note="$note_title"
            fi
            if [[ "$target_note" == "$note_title" ]]; then
              echo "Refusing recursive apple-notes checklist call on active note: $note_title" >&2
              return 1
            fi
            echo "- Apple Notes Checklist: $target_note"
            "$APPLE_NOTES_SCRIPT" "$target_note"
            ;;
        esac
        return 0
        ;;

      apple-reminders)
        echo "- Apple Reminders"
        run_shell_with_prefix "remindctl" "$skill_args"
        return 0
        ;;

      bird-x|bird)
        echo "- Bird X"
        run_shell_with_prefix "bird" "$skill_args"
        return 0
        ;;

      browser-use)
        echo "- Browser Use"
        if command -v browser-use >/dev/null 2>&1; then
          run_shell_with_prefix "browser-use" "$skill_args"
          return 0
        fi
        echo "  browser-use CLI is not on PATH. Falling back to codex exec."
        run_codex_skill "browser-use" "$skill_args"
        return 0
        ;;

      confetti)
        echo "- Confetti"
        "$CONFETTI_SCRIPT"
        return 0
        ;;

      discord)
        echo "- Discord (via codex exec)"
        run_codex_skill "discord" "$skill_args"
        return 0
        ;;

      ffmpeg-video-editor)
        if [[ -z "$skill_args" ]]; then
          echo "ffmpeg-video-editor requires args. Example: ffmpeg-video-editor: -i input.mp4 -ss 00:00:05 -to 00:00:10 -c copy output.mp4" >&2
          return 1
        fi
        echo "- FFmpeg Video Editor"
        run_shell_with_prefix "ffmpeg -y -hide_banner" "$skill_args"
        return 0
        ;;

      git-search)
        echo "- Git Search"
        if [[ -z "$skill_args" ]]; then
          "$GIT_SEARCH_SCRIPT" --count 10
        else
          run_shell_with_prefix "$GIT_SEARCH_SCRIPT" "$skill_args"
        fi
        return 0
        ;;

      imsg)
        echo "- iMessage"
        run_shell_with_prefix "imsg" "$skill_args"
        return 0
        ;;

      launchd-non-apple-jobs)
        echo "- Launchd Non-Apple Jobs"
        case "$first_word" in
          ""|show|list)
            "$LAUNCHD_SHOW_SCRIPT"
            ;;
          create)
            run_shell_with_prefix "$LAUNCHD_CREATE_SCRIPT" "$rest"
            ;;
          delete|remove)
            run_shell_with_prefix "$LAUNCHD_DELETE_SCRIPT" "$rest"
            ;;
          *)
            run_shell_with_prefix "$LAUNCHD_CREATE_SCRIPT" "$skill_args"
            ;;
        esac
        return 0
        ;;

      mailapp-send-email|mail-app-send-email)
        if [[ -z "$skill_args" ]]; then
          echo "mailapp-send-email requires args. Example: mailapp-send-email: --to \"test@test.com\" --subject \"hello\" --body \"testing\"" >&2
          return 1
        fi
        echo "- Mail.app Send Email"
        run_shell_with_prefix "osascript $MAILAPP_SCRIPT" "$skill_args"
        return 0
        ;;

      open-meteo-weather)
        echo "- Open-Meteo Weather"
        if [[ -z "$skill_args" ]]; then
          echo "open-meteo-weather requires args. Example: open-meteo-weather: --location \"Boston, MA\"" >&2
          return 1
        fi
        run_shell_with_prefix "python3 $OPEN_METEO_SCRIPT" "$skill_args"
        return 0
        ;;

      openai-docs)
        echo "- OpenAI Docs (via codex exec)"
        run_codex_skill "openai-docs" "$skill_args"
        return 0
        ;;

      opml-reader)
        echo "- OPML Reader"
        if [[ -z "$skill_args" ]]; then
          echo "opml-reader requires args. Example: opml-reader: latest ~/Code/Files/feeds.opml --limit 5" >&2
          return 1
        fi
        run_shell_with_prefix "python3 $OPML_READER_SCRIPT" "$skill_args"
        return 0
        ;;

      playwright)
        echo "- Playwright"
        run_playwright_command "$skill_args"
        return 0
        ;;

      say)
        if [[ -z "$skill_args" ]]; then
          echo "say requires text. Example: say: Hello Ivan" >&2
          return 1
        fi
        run_say_skill "$skill_args"
        return 0
        ;;

      screen-recorder)
        echo "- Screen Recorder"
        if [[ -z "$skill_args" ]]; then
          "$SCREEN_RECORDER_SCRIPT" --seconds 10
          return 0
        fi
        if [[ "$skill_args" =~ ^[0-9]+$ ]]; then
          "$SCREEN_RECORDER_SCRIPT" --seconds "$skill_args"
          return 0
        fi
        run_shell_with_prefix "$SCREEN_RECORDER_SCRIPT" "$skill_args"
        return 0
        ;;

      swiftui-performance-audit)
        echo "- SwiftUI Performance Audit (via codex exec)"
        run_codex_skill "swiftui-performance-audit" "$skill_args"
        return 0
        ;;

      video-transcript-downloader)
        echo "- Video Transcript Downloader"
        if [[ -z "$skill_args" ]]; then
          echo "video-transcript-downloader requires args. Example: video-transcript-downloader: transcript --url 'https://...'" >&2
          return 1
        fi
        run_shell_with_prefix "node $VTD_SCRIPT" "$skill_args"
        return 0
        ;;

      yahoo-finance|yahoo-finance-mz1nt)
        echo "- Yahoo Finance (via codex exec)"
        run_codex_skill "yahoo-finance" "$skill_args"
        return 0
        ;;

      youtube|youtube-data-api)
        echo "- YouTube Data API"
        if command -v uv >/dev/null 2>&1; then
          if run_shell_with_prefix "uv run $YOUTUBE_SCRIPT" "$skill_args"; then
            return 0
          fi
        else
          if run_shell_with_prefix "python3 $YOUTUBE_SCRIPT" "$skill_args"; then
            return 0
          fi
        fi
        echo "  YouTube local runner failed. Falling back to codex exec."
        run_codex_skill "youtube" "$skill_args"
        return 0
        ;;

      yt-video-downloader)
        echo "- YouTube Video Downloader"
        if [[ -z "$skill_args" ]]; then
          echo "yt-video-downloader requires args. Example: yt-video-downloader: \"https://youtube.com/watch?v=...\"" >&2
          return 1
        fi
        if command -v yt-dlp >/dev/null 2>&1; then
          run_shell_with_prefix "yt-dlp" "$skill_args"
          return 0
        fi
        echo "  yt-dlp is not on PATH. Falling back to codex exec."
        run_codex_skill "yt-video-downloader" "$skill_args"
        return 0
        ;;

      skill-creator)
        echo "- Skill Creator"
        case "$first_word" in
          ""|init)
            run_shell_with_prefix "python3 $SKILL_CREATOR_INIT_SCRIPT" "$rest"
            ;;
          validate|check)
            run_shell_with_prefix "python3 $SKILL_CREATOR_VALIDATE_SCRIPT" "$rest"
            ;;
          yaml|generate|generate-openai-yaml)
            run_shell_with_prefix "python3 $SKILL_CREATOR_YAML_SCRIPT" "$rest"
            ;;
          *)
            run_shell_with_prefix "python3 $SKILL_CREATOR_INIT_SCRIPT" "$skill_args"
            ;;
        esac
        return 0
        ;;

      skill-installer)
        echo "- Skill Installer"
        case "$first_word" in
          ""|list|ls)
            run_shell_with_prefix "python3 $SKILL_INSTALLER_LIST_SCRIPT" "$rest"
            ;;
          install|add)
            run_shell_with_prefix "python3 $SKILL_INSTALLER_INSTALL_SCRIPT" "$rest"
            ;;
          -*)
            run_shell_with_prefix "python3 $SKILL_INSTALLER_LIST_SCRIPT" "$skill_args"
            ;;
          *)
            run_shell_with_prefix "python3 $SKILL_INSTALLER_INSTALL_SCRIPT" "$skill_args"
            ;;
        esac
        return 0
        ;;
    esac
  fi

  dispatch_natural_language_item "$item_text" "$normalized_item"
  return $?
}

if [[ -z "$NORMALIZED_INPUT" ]]; then
  NORMALIZED_INPUT="$(printf '%s' "$ITEM_TEXT" | tr '[:upper:]' '[:lower:]' | tr -s ' ' | sed 's/^ *//;s/ *$//')"
fi

if dispatch_skill_item "$NOTE_TITLE" "$ITEM_TEXT" "$NORMALIZED_INPUT"; then
  exit 0
else
  exit $?
fi
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall