tech-storyteller

Extract development narratives from Git history and repository documentation.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/Keiji-Miyake/agent-skills --skill tech-storyteller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-storyteller
Source: https://github.com/Keiji-Miyake/agent-skills/tree/main/skills/tech-storyteller
Command: npx skills add https://github.com/Keiji-Miyake/agent-skills --skill tech-storyteller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams extract the development narrative from repository histories and logs, converting scattered information into structured material ready for blogs, reports, or documentation.

Core Features & Use Cases

  • Repository archaeology: analyzes Git history, diffs, and PR descriptions to surface key changes and rationales.
  • Insight extraction: links decisions from architecture notes, task plans, and design docs to explain the "why" behind changes.
  • Output generation: produces Markdown-ready material that can be repurposed for articles, release notes, or internal knowledge bases.

Quick Start

Use the tech-storyteller skill to generate an outline of potential blog topics from your current repository history.

Frequently Asked Questions about tech-storyteller

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

FAQPage Schema
How do I extract development narratives from git commit history for a blog post?

You can turn git repository history into structured material by reading Git commit messages, ARCHITECTURE.md, and CHANGELOG.md to produce ready-to-use Markdown outlines for articles and documentation.

Can I generate release notes from repository history and architecture documentation?

Yes, you can generate release notes from repository history by analyzing commit logs, ARCHITECTURE.md, and CHANGELOG.md to produce structured Markdown material explaining the rationale behind code changes.

What is the best way to convert Git commits and changelogs into structured knowledge base articles?

The best way to convert Git commits into knowledge base articles is linking decisions from architecture notes and design docs to commit diffs to explain the why behind changes and produce Markdown-ready material.

Does this approach to repository archaeology work with existing ARCHITECTURE.md and CHANGELOG.md files?

Repository archaeology works directly with existing ARCHITECTURE.md and CHANGELOG.md files, reading Git commit messages and task documents to extract structured development narratives without requiring external plugins.

How do I document the why behind code changes using historical task plans and walkthroughs?

Document the why behind code changes by linking historical task plans and walkthrough documents to Git diffs, extracting decision rationales from architecture notes to compile structured development narratives.

What are the limitations of extracting design notes from repository history and logs?

Limitations of extracting design notes from repository history include relying entirely on the quality and detail of existing Git commit messages, ARCHITECTURE.md, and task documentation to build coherent narratives.