Code Story Skill
Provides narrative templates for transforming git history into documentary-style stories.
Templates
Read the appropriate template based on detail level:
-
references/minimal-template.md - 1-2 page executive summary
-
references/standard-template.md - 5-10 page story with acts
-
references/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