code-story

Code Story Skill

Provides narrative templates for transforming git history into documentary-style stories.

Templates

Read the appropriate template based on detail level:

• resources/minimal-template.md - 1-2 page executive summary
• resources/standard-template.md - 5-10 page story with acts
• resources/comprehensive-template.md - 20+ page deep dive

Narrative Guidelines

Voice and Tone

• Documentary style: informative yet engaging
• Third-person perspective
• Acknowledge the human element
• Find the drama in technical decisions
• Celebrate achievements without hyperbole

What Makes a Good Code Story

• Genesis moment: First commit sets the stage
• Character development: Contributors evolve
• Conflict and resolution: Bugs, refactors, breaking changes
• Turning points: Direction-changing decisions
• Present connection: Link past to current state

Commit Citation Format

• Short SHA in backticks: abc1234
• Include date and author for key commits
• Link to GitHub if remote is github.com