archibate/dotfiles-opencode / skills/librarian
librarian
VerifiedCache and refresh remote git repositories under ~/.cache/checkouts/<host>/<org>/<repo> so future references can reuse a local copy. Use this skill when the user points you to a remote git repository as reference or you encountered a remote git repo through other means.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| checkout.sh | script | 6.3 KB |
checkout.sh
View on GitHub#!/usr/bin/env bash
set -euo pipefail
usage() {
cat <<'EOF'
Usage: checkout.sh <repo> [options]
Ensure a cached checkout exists at:
~/.cache/checkouts/<host>/<org>/<repo>
Examples:
checkout.sh mitsuhiko/minijinja
checkout.sh github.com/mitsuhiko/minijinja
checkout.sh https://github.com/mitsuhiko/minijinja
checkout.sh git@github.com:mitsuhiko/minijinja.git
Options:
--path-only Print only the checkout path.
--force-update Always fetch from origin and attempt fast-forward.
--update-interval <secs> Minimum seconds between updates (default: 300).
Environment:
LIBRARIAN_CACHE_ROOT Override cache root (default: ~/.cache/checkouts)
LIBRARIAN_DEFAULT_HOST Host for owner/repo shorthand (default: github.com)
LIBRARIAN_UPDATE_INTERVAL Default update interval in seconds
EOF
}
if [[ $# -lt 1 ]]; then
usage
exit 1
fi
repo_input=""
path_only=0
force_update=0
update_interval="${LIBRARIAN_UPDATE_INTERVAL:-300}"
while [[ $# -gt 0 ]]; do
case "$1" in
--path-only)
path_only=1
shift
;;
--force-update)
force_update=1
shift
;;
--update-interval)
if [[ $# -lt 2 ]]; then
echo "error: --update-interval expects a value" >&2
exit 2
fi
update_interval="$2"
shift 2
;;
-h|--help)
usage
exit 0
;;
*)
if [[ -z "$repo_input" ]]; then
repo_input="$1"
else
echo "error: unexpected argument: $1" >&2
exit 2
fi
shift
;;
esac
done
if [[ -z "$repo_input" ]]; then
echo "error: repository is required" >&2
exit 2
fi
if ! [[ "$update_interval" =~ ^[0-9]+$ ]]; then
echo "error: update interval must be a non-negative integer" >&2
exit 2
fi
trim_repo_input() {
local s="$1"
# Trim leading/trailing whitespace.
s="${s#${s%%[![:space:]]*}}"
s="${s%${s##*[![:space:]]}}"
printf '%s' "$s"
}
parse_repo() {
local input host path first rest
input="$(trim_repo_input "$1")"
# Strip query/fragment for URL-like inputs.
input="${input%%\?*}"
input="${input%%#*}"
case "$input" in
git@*:* )
host="${input#git@}"
host="${host%%:*}"
path="${input#*:}"
;;
ssh://* )
rest="${input#ssh://}"
host="${rest%%/*}"
host="${host#*@}"
path="${rest#*/}"
;;
http://*|https://* )
rest="${input#*://}"
host="${rest%%/*}"
path="${rest#*/}"
;;
*/* )
first="${input%%/*}"
if [[ "$first" == *.* || "$first" == localhost ]]; then
host="$first"
path="${input#*/}"
else
host="${LIBRARIAN_DEFAULT_HOST:-github.com}"
path="$input"
fi
;;
* )
echo "error: unsupported repository format: $input" >&2
return 1
;;
esac
host="${host#*@}"
path="${path#/}"
path="${path%/}"
# For GitHub-like deep links, use owner/repo only.
IFS='/' read -r -a parts <<< "$path"
if [[ ${#parts[@]} -ge 3 ]]; then
case "${parts[2]}" in
tree|blob|pull|issues|commit|actions|releases|compare|wiki)
path="${parts[0]}/${parts[1]}"
;;
esac
fi
# Strip optional .git suffix.
path="${path%.git}"
IFS='/' read -r -a parts <<< "$path"
if [[ ${#parts[@]} -lt 2 ]]; then
echo "error: repository path must contain at least org/repo: $path" >&2
return 1
fi
local last_index=$(( ${#parts[@]} - 1 ))
local repo="${parts[$last_index]}"
local org_parts=("${parts[@]:0:$last_index}")
local org
org="$(IFS='/'; echo "${org_parts[*]}")"
if [[ -z "$host" || -z "$org" || -z "$repo" ]]; then
echo "error: failed to parse repository: $input" >&2
return 1
fi
printf '%s\n%s\n%s\n' "$host" "$org" "$repo"
}
parsed_host=""
parsed_org=""
parsed_repo=""
parsed_index=0
while IFS= read -r line; do
case "$parsed_index" in
0) parsed_host="$line" ;;
1) parsed_org="$line" ;;
2) parsed_repo="$line" ;;
esac
parsed_index=$((parsed_index + 1))
done < <(parse_repo "$repo_input")
host="$parsed_host"
org="$parsed_org"
repo="$parsed_repo"
cache_root="${LIBRARIAN_CACHE_ROOT:-$HOME/.cache/checkouts}"
checkout_path="$cache_root/$host/$org/$repo"
origin_url="https://$host/$org/$repo.git"
mkdir -p "$(dirname "$checkout_path")"
if [[ ! -d "$checkout_path/.git" ]]; then
git clone --filter=blob:none "$origin_url" "$checkout_path" >/dev/null
clone_state="cloned"
else
clone_state="existing"
fi
if [[ ! -d "$checkout_path/.git" ]]; then
echo "error: checkout path is not a git repository: $checkout_path" >&2
exit 3
fi
if ! git -C "$checkout_path" remote get-url origin >/dev/null 2>&1; then
git -C "$checkout_path" remote add origin "$origin_url"
fi
# If remote URL changed (e.g. host shorthand), normalize to canonical HTTPS URL.
current_origin="$(git -C "$checkout_path" remote get-url origin 2>/dev/null || true)"
if [[ "$current_origin" != "$origin_url" ]]; then
git -C "$checkout_path" remote set-url origin "$origin_url"
fi
last_fetch_file="$checkout_path/.git/librarian-last-fetch"
now_epoch="$(date +%s)"
needs_update=1
if [[ -f "$last_fetch_file" && "$force_update" -eq 0 ]]; then
last_epoch="$(cat "$last_fetch_file" 2>/dev/null || echo 0)"
if [[ "$last_epoch" =~ ^[0-9]+$ ]]; then
age=$(( now_epoch - last_epoch ))
if (( age < update_interval )); then
needs_update=0
fi
fi
fi
update_state="skipped"
ff_state="not-attempted"
if (( needs_update == 1 )); then
git -C "$checkout_path" fetch --prune --tags origin >/dev/null
echo "$now_epoch" > "$last_fetch_file"
update_state="fetched"
branch="$(git -C "$checkout_path" symbolic-ref --short -q HEAD 2>/dev/null || true)"
upstream="$(git -C "$checkout_path" rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null || true)"
dirty="$(git -C "$checkout_path" status --porcelain --untracked-files=no)"
if [[ -n "$branch" && -n "$upstream" && -z "$dirty" ]]; then
if git -C "$checkout_path" merge --ff-only "$upstream" >/dev/null 2>&1; then
ff_state="fast-forwarded"
else
ff_state="skipped-non-ff"
fi
elif [[ -n "$dirty" ]]; then
ff_state="skipped-dirty"
else
ff_state="skipped-no-upstream"
fi
fi
if (( path_only == 1 )); then
printf '%s\n' "$checkout_path"
exit 0
fi
cat <<EOF
repo: $host/$org/$repo
path: $checkout_path
state: $clone_state
update: $update_state
fast_forward: $ff_state
EOF
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 470k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |