Do I need the GitHub CLI installed to use this skill?

Yes, this skill relies on the 'gh' command-line tool to fetch live PR data, comments, and diffs from your repository.

What is the 'story-diff' format used in the output?

The 'story-diff' format is a specialized markdown block that includes a JSON metadata header. This allows the output to be both human-readable and easily parseable by other tools for visualization.

Can it handle very large pull requests with thousands of lines?

Yes, it is specifically designed to be opinionated and selective. It skips boilerplate and trivial changes to focus on the most structurally significant logic, ensuring the final story remains readable.

How does this differ from a standard PR description?

While a PR description is usually a static summary, this skill analyzes the entire commit history and discussion to narrate the evolution of the code, explaining how the solution changed from the first commit to the final review.

PR Story Generator

Name: PR Story Generator
Author: forketyfork

byforketyfork

0•

Collaboration Tools

Transforms technical pull request data into structured narratives with embedded code snippets and evolution context.

The PR Story Generator skill enhances Claude's ability to document and explain complex code changes by weaving GitHub PR data into a cohesive narrative. It automatically fetches metadata, commit history, and review discussions using the GitHub CLI to explain not just what changed, but how and why the code evolved. By generating specialized Markdown files with line-referenced prose and structured code blocks, it serves as a powerful tool for knowledge sharing, onboarding, and deep-dive code reviews where the author's intent and team feedback are crucial for understanding.

Key Features

010 GitHub stars

02Automated extraction of PR metadata, commit history, and review comments via GitHub CLI

03Intelligently filters large diffs to focus on high-impact architectural and logic changes

04Uses specialized story-diff code blocks with JSON metadata for enhanced visualization and parsing

05Implements a cross-referencing system between prose explanations and specific code lines

06Generates chronological narratives that track the evolution of a feature through multiple commits

Use Cases

01Onboarding developers to complex feature sets by providing a guided walkthrough of the implementation history

02Synthesizing lengthy PR discussions into a concise summary of decisions and trade-offs

03Creating high-quality documentation for architectural changes and major refactors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add forketyfork/agentic-skills review-story

For use in Claude.ai and ChatGPT

Download Skill