branch-history

Generate a branch-tagged architectural history report in BRANCH_HISTORY.md.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/0xxmemo/litellmctl --skill branch-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-history
Source: https://github.com/0xxmemo/litellmctl/tree/main/skills/branch-history
Command: npx skills add https://github.com/0xxmemo/litellmctl --skill branch-history

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates a regenerable BRANCH_HISTORY.md at the repository root that explains the current git branch's state from its divergence with the base to HEAD, organized into Start, Mid, and End sections. It tags the file to the active branch so switching branches prompts a regeneration when invoked on a different branch.

Core Features & Use Cases

  • Creates a single BRANCH_HISTORY.md summarizing the branch architecture.
  • Recomputes from scratch on every invocation using git commands and repository reads to reflect the latest state.
  • Useful for onboarding, code reviews, and architectural audits by presenting a narrative of the branch.

Quick Start

Run the branch-history skill to generate a fresh BRANCH_HISTORY.md for the current branch.

Frequently Asked Questions about branch-history

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a changelog from a git branch divergence point?

To generate a changelog from a git branch divergence point, you need a tool that computes the merge-base and reads git logs to build a narrative history. This skill automates that process by regenerating a BRANCH_HISTORY.md file from the base to HEAD.

What is the best way to document feature branch architecture for code reviews?

Documenting feature branch architecture for code reviews is best handled by generating a structured report that captures changes from the divergence point. This skill creates a BRANCH_HISTORY.md file organized into narrative sections to provide a readable architectural audit trail.

Can I automatically track git branch history changes for developer onboarding?

You can automatically track git branch history for onboarding by regenerating a markdown file on each invocation. This skill tags the document to the active branch and recomputes the full history using git commands to reflect the latest repository state.

Does the branch history report update automatically when switching git branches?

The branch history report does not update automatically on its own, but switching branches prompts a regeneration when the skill is invoked. It uses an HTML-comment header to tag the document to the current branch, ensuring the narrative matches the active context.

How to create a readable architectural history from git merge-base?

Creating a readable architectural history from a git merge-base involves capturing diffs and logs between the base and HEAD. This skill computes the divergence using git commands and writes the results into a structured markdown file for architectural audits.

When do I need to regenerate a branch history markdown file?

You need to regenerate a branch history markdown file whenever the current branch diverges further or when switching to a different branch. Because the skill recomputes from scratch on every run, invoking it ensures the architectural narrative reflects the latest commits.