← Skills

any stack

history

Reconstruct the full history of an issue, feature, or topic — what we've tried, in order, and what happened each time. Use when the user asks "what did we do last on X", "what have we tried on <issue/topic>", "history of #N", "previous attempts", "catch me up on <area>", or points at an issue and wants the backstory.

invocationmodel + manual
install leveluser — once via scripts/install-skills into ~/.claude/skills (Cursor reads the same directory; all projects); a repo can override it at .claude/skills/history/
disable-model-invocation
install (this skill)curl -fLo ~/.claude/skills/history/SKILL.md --create-dirs https://vilya.jerrodtuck.com/skills/history/SKILL.md

Body

History — what have we done on this?

Scope: Internal dev-process skill, read-only — it reconstructs and reports, never writes. Companion to /start-feature · /finish-feature · /update-docs. Repo / owner / project live in this repo's docs/project-tracking/GITHUB-PROJECTS.md config block.

The board, the PRs, and any in-repo history (specs, decisions, changelog, frozen legacy trackers) each hold a piece of the story. This skill stitches them into one chronological answer. Run the gh queries against <owner>/<repo> from the config — and against sibling repos when the topic spans them.

1. Resolve the target

2. Gather the sources (breadth-first; the timeline is the spine)

For each target issue:

  1. Timeline — the backbone. gh api repos/<owner>/<repo>/issues/<n>/timeline shows labels, project_v2_item_status_changed (Todo→In Progress→…→Done), reopens, cross-referenced (related issues/PRs), and closed/merge-commit references. Each linked PR is an attempt.
  2. Body + commentsgh issue view <n> --repo <owner>/<repo> --comments. The original report, provenance ids, and any decision notes.
  3. Related / linked issues — cross-referenced issues from the timeline; parent/sub-issues; and same-area issues (gh issue list --repo <owner>/<repo> --search "<area/keywords>" --state all).
  4. The PRs (the actual attempts) — for each linked PR: gh pr view <pr> --repo <owner>/<repo> --json title,mergedAt,body,files plus its release note (grep docs/project-tracking/changelog.d/ for the slug / PR number).
  5. Decisions & reversals — grep docs/DECISIONS.md for the topic (rationale, removed features, "superseded by").
  6. Pre-migration forensics (only if applicable) — if the repo kept legacy trackers before its GitHub-Projects migration and the issue traces to a legacy id (BUG-…, fb_…), grep those and note the origin. Repos with no legacy trackers skip this.
  7. Code trail (optional)git log --grep "#<n>" for the commits.

3. Synthesize — a skimmable "what we tried"

Lead with the answer, not the raw dump:

Guardrails

Version history

No git history yet — commit this skill to the repo and versions appear here automatically.