菜单
Find, cache, and refresh git repositories — both local projects and remote repos. Uses the gum CLI to discover existing checkouts under ~/*/ before cloning. Use when the user references a git repository (URL, org/repo, or local path) or when you need to locate a project on disk.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | git-repo-discovery |
| description | Find, cache, and refresh git repositories — both local projects and remote repos. Uses the gum CLI to discover existing checkouts under ~/*/ before cloning. Use when the user references a git repository (URL, org/repo, or local path) or when you need to locate a project on disk. |
Find local git repositories or cache remote ones for reference. Prefers discovering existing checkouts over cloning — your machine likely already has what you need.
| Task | Command |
|---|---|
| Find a local repo | gum projects --format json | jq '.[] | select(.path | test("PATTERN"))' |
| List all local repos | gum projects --format simple |
| Search by remote URL | gum projects --format json | jq '.[] | select(.remote | test("org/repo"))' |
| Clone with smart placement | gum clone org/repo |
| Suggest clone location | gum clone --suggest org/repo |
| Cache a remote repo | scripts/checkout.sh <repo> --path-only |
| Force-refresh a cached repo | scripts/checkout.sh <repo> --force-update --path-only |
Before cloning anything, always check if the repo already exists locally:
# Step 1: Search local projects (fast — uses gum's indexed DB)
gum projects --format json | jq -r '.[] | select(.remote | test("SEARCH_TERM")) | .path'
# Step 2: If not found locally, check the cache
scripts/checkout.sh org/repo --path-only
# Step 3: Only clone if truly missing (gum picks the right directory)
gum clone org/repo
The gum CLI maintains an indexed database of all git repos under ~/:
# All repos as JSON (path, remote, branch)
gum projects --format json
# Simple list of paths
gum projects --format simple
# Force re-scan
gum projects --refresh --format simple
# Search examples
gum projects --format json | jq -r '.[] | select(.path | test("terraform")) | .path'
gum projects --format json | jq -r '.[] | select(.remote | test("shalomb")) | "\(.path)\t\(.remote)"'
For repos not already on disk, use scripts/checkout.sh to cache under
~/.cache/checkouts/<host>/<org>/<repo>:
# These all resolve to the same checkout:
scripts/checkout.sh mitsuhiko/minijinja --path-only
scripts/checkout.sh github.com/mitsuhiko/minijinja --path-only
scripts/checkout.sh https://github.com/mitsuhiko/minijinja --path-only
scripts/checkout.sh git@github.com:mitsuhiko/minijinja.git --path-only
Features:
--filter=blob:none) for efficiency--force-updateWhen a repo needs to be cloned (not just cached), use gum clone which
analyses your existing project structure and suggests the right directory:
# Clone with intelligent directory suggestion
gum clone hashicorp/terraform
# Just see where it would go
gum clone --suggest hashicorp/terraform
# Force a specific location
gum clone --target ~/projects/hashicorp/terraform hashicorp/terraform
checkout.sh when you
just need to read/reference; use gum clone when you need a proper
working copy.find if gum is unavailable.Convert URLs or local files (PDF/DOCX/PPTX/HTML) to Markdown, with optional summarization. Single or batch processing. Uses markitdown for intelligent extraction, falls back to curl+pandoc. Use when fetching web pages as markdown, converting documents for analysis, or producing quick summaries.
Use `uv` instead of pip/python/venv. Run scripts with `uv run script.py`, add deps with `uv add`, use inline script metadata for standalone scripts.
Adversarial code reviewer. Use when you need a quality agent to critically review code, a diff, test output, or a pull request — looking for bugs, edge cases, correctness failures, lazy shortcuts, and pattern violations. Works standalone (against any code/diff/worktree) or with GitHub PR mechanics (inline comments, merge decision) when a PR number is provided. Triggers: "bart", "review this", "adversarial review", "code review", "review PR", "find bugs", "QA", "quality check".
Use this skill to orchestrate multiple parallel sub-agents (Ralph/Bart) across isolated git worktrees to burn down a TODO.md backlog. Trigger this when asked to implement multiple independent features simultaneously, dispatch a "wave of agents", or perform "multi-agent orchestration". This handles complex dependency analysis, model spread, and feedback accumulation, which standard dispatch skills cannot.
Launch Claude Code CLI as a headless sub-agent in a tmux pane, monitor its stream-json JSONL output, and poll for completion. Use when delegating a well-defined coding task (bug fix, feature, refactor) to a Claude agent subprocess with live observability. Triggers include "run claude agent", "delegate to claude", "claude sub-agent", or any request to run claude headlessly and monitor it.
Launch GitHub Copilot CLI as a headless sub-agent in a tmux pane, monitor its JSONL output stream, and poll for completion. Use when delegating a well-defined coding task (bug fix, feature, refactor) to a Copilot agent subprocess with live observability. Triggers include "run copilot agent", "delegate to copilot", "copilot sub-agent", or any request to run copilot headlessly and monitor it.