agent-ops-git-story
Generate narrative summaries from git history for onboarding, retrospectives, changelogs, and exploration. LLM-enhanced when available, works without LLM too.
npx skills add majiayu000/claude-skill-registry --skill agent-ops-git-story --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Git Story Skill Generate human-readable narratives from git commit history. Useful for: - **Onboarding** — Help new team members understand project evolution - **Retrospectives** — Create sprint/milestone summaries - **Changelogs** — Generate release notes from commits - **Exploration** — Understand "what happened here?" for any period ## Requirements - **Git**: Must be installed locally and available on PATH - **LLM**: Optional — enhanced narratives when available, templated output without ## Data Extraction **Works with or without `aoc` CLI installed.** Story generation uses raw `git log` commands by default. ### Git Commands (Default) | Operation | Command | |---------|---------| | Recent commits | `git log --oneline -N` | | Date range | `git log --since="YYYY-MM-DD" --until="YYYY-MM-DD"` | | By author | `git log --author="name"` | | Detailed | `git log --stat --since="YYYY-MM-DD"` | | JSON-like | `git log --format="%H|%an|%ad|%s" --date=short` | ### CLI Integration (when aoc is available) When `aoc` CLI is detected in `.agent/tools.json`, enhanced commands are available: | Command | Description | |---------|-------------| | `aoc git story` | Generate narrative from commits |
- Requirements
- Data Extraction
- Git Commands (Default)
- CLI Integration (when aoc is available)
- Story Command Options (CLI)
- Examples
- Agent Workflow
- 1. Gather Requirements
- 2. Extract Data
- 3. Enhance with LLM (Optional)
- 4. Without LLM
- Output Formats
- Narrative (default)
- Changelog
aoc git story [OPTIONS] Last 30 days of activity aoc git story --since 2026-01-01 Generate changelog format aoc git story --last 50 --format changelog Filter by author, group by type aoc git story --author "John Doe" --group type Export to file aoc git story --last 100 --output story.md Quick stats
What does the agent-ops-git-story skill do?
Generate narrative summaries from git history for onboarding, retrospectives, changelogs, and exploration. LLM-enhanced when available, works without LLM too.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agent-ops-git-story --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
