Files
holocron/plugins/git/skills/git-history/README.md
Defame1297 7cb8e95379 refactor(git-history): retrofit to the ADR-0020 context contract
Description 450 -> 266 chars, body 1044 -> 462 words. The bisect procedure
moves to references/bisect.md.

The boundary clause read 'not writing or rewriting commits', which
disclaimed the cherry-pick and revert this skill's own Step 3 executes; it
now excludes authoring and rebasing only. Adds 'backport' so cherry-pick is
reachable by natural language at all, accepting 266 chars against a 250
soft target and a 400 ceiling.
2026-08-30 13:10:53 +00:00

1.7 KiB

git-history

Inspect git history — log queries, bisect, and locating problematic commits.

What it does

This skill handles history inspection within the git workflow suite. It queries logs with pickaxe/line-range/custom formats, runs bisect to find bug-introducing commits, and locates commits for downstream cherry-picking or reverting. It returns structured results for agent composition. Rebase, squash, fixup, and other history-rewriting operations are owned by git-commits, not this skill.

Composition

git-branches delegates cherry-pick and revert here (see git-branches's references/merging.md), which is why this skill carries those two operations rather than treating them as out of scope. They are general git knowledge, not drawn from the history-inspection.md research corpus. Server-side commit history on a Gitea-hosted repository belongs to gitea-branches; this skill reads the local working copy.

Usage

/git-history

Describe your history task: search logs, bisect for a regression, or locate a specific commit. The skill will query history and return structured results.

Files

File Purpose
SKILL.md Skill instructions for agents
references/bisect.md Loaded when the entry procedure is bisect: manual and automated flows, exit codes, skip, replay, narrowing, custom terms
references/git-log-format.md Loaded when a log or diff flag needs looking up: format placeholders, presets, diff-filter letters, -L syntax, ancestry filters, pickaxe binary-file behaviour, diff output-control flags
references/sources.md Research sources and provenance
references/README.md Index of the references directory