| name | git-diff |
| description | Capture the current git diff (staged, working-tree, or staged file list) as text. Direct shell call for workflows that need repository diffs without an LLM agent loop. |
| provenance | {"origin":"agentos-original","license":"MIT"} |
| metadata | {"requires":{"bins":["git"]}} |
| entrypoint | {"command":"python {baseDir}/scripts/git_diff.py","args":["--mode","{{ with.mode | default('cached_fallback_worktree') }}","--cwd","{{ with.cwd | default('.') }}"],"parse":"text","timeout":30} |
git-diff (sub-skill)
Direct shell invocation that returns the current git diff as text.
Replaces sub-agent sub-Agent steps that just shell out to
git diff — order-of-magnitude faster (no LLM round-trip).
Modes
mode (with.mode) | behaviour |
|---|
cached_fallback_worktree | git diff --cached HEAD; falls back to git diff HEAD if staged diff is empty. Default. |
cached | git diff --cached HEAD only |
worktree | git diff HEAD only |
staged_files | git diff --cached --name-only (path list) |
Output
- Non-empty diff: raw unified diff text on stdout.
- Empty (no changes): exits 0 with the literal
NO_DIFF on stdout so
downstream meta-step prompts can short-circuit reviewers.
- git not a repo / git error: exit 1, stderr carries the cause.
Fallback
If this skill is unavailable, callers should spawn sub-agent
with a git diff task — same output, ~10× the latency.
