change-story

Generate two-column PR walkthroughs with prose narrative and comprehensive code map.

Updated May 21, 2026
One-click install
npx skills add https://github.com/love-lena/skills --skill change-story-love-lena
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-story
Source: https://github.com/love-lena/skills/tree/main/skills/change-story
Command: npx skills add https://github.com/love-lena/skills --skill change-story-love-lena

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Standard diff views fragment the story of a large pull request or stacked PRs across pages, making it hard for reviewers to understand what changed and why. This Skill turns any diff into a readable two-column walkthrough: a curated prose chapter on the left and a comprehensive, surface-grouped code map on the right. ## Core Features & Use Cases - Two-column walkthrough generation: Produces prose.md (a continuous narrative naming consequences), map.md (every hunk in the diff grouped by surface with framing paragraphs), and diff.patch (the verbatim unified diff). - Chip cross-linking: Inline line-range markdown links in the prose point directly at hunks in the map, so readers can jump from a consequence to the exact mechanics. - Coverage audit: A built-in audit checklist verifies every + line in the diff is covered by a map fence and that addition/deletion totals match the change header. - Use Case: You have a 6-PR stack touching 40 files. Run this Skill to produce a walkthrough where reviewers read a short prose chapter for the story and consult the map for every hunk, instead of scrolling a fragmented diff view. ## Quick Start Generate a change story for the current pull request using its diff, title, and description.

Frequently Asked Questions about change-story

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

FAQPage Schema
How do I create a PR walkthrough from a diff?

Provide the unified diff (from git diff or gh pr diff), the PR title, and description. The Skill writes map.md first with every hunk grouped by surface, then prose.md as a short narrative with chip links pointing at line ranges in the map.

What is a change story for code review?

A change story is a two-column walkthrough of a code change: a continuous prose chapter naming what changed and why on the left, and a surface-grouped code map covering every diff hunk on the right. It outputs three markdown artifacts: prose.md, map.md, and diff.patch.

Does change-story work with stacked pull requests?

Yes, stacked PRs are a primary use case. Provide the combined diff across the stack's commits, and the map groups hunks by surface rather than by PR number, so related changes across PRs appear together.

Can I use change-story without a special renderer?

Yes. The three output files are plain markdown and readable on their own. A renderer that understands the chip-and-fence convention can additionally lay them out as a two-column page with expandable hunks.

What are the limitations of generated PR narratives?

The prose must be grounded in the diff; PR body claims not visible in the diff are quoted as evidence or marked [NEEDS INFO]. The Skill instructs narrowing scope rather than inventing causation when the reasoning behind a change cannot be determined.