story-miner

Extract publishable development stories from Claude Code session history with provenance.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/BryceEWatson/bryce-labs-toolkit --skill story-miner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-miner
Source: https://github.com/BryceEWatson/bryce-labs-toolkit/tree/main/skills/story-miner
Command: npx skills add https://github.com/BryceEWatson/bryce-labs-toolkit --skill story-miner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mines Claude Code session history to produce publishable development stories that can be shared for documentation, learning, and onboarding. It grounds quotes with provenance and ensures safe redaction, enabling reliable storytelling from internal logs.

Core Features & Use Cases

  • Mines Claude Code session history to extract publishable development stories with grounded quotes and provenance pointers
  • Deduplicates similar incidents and scores candidates for narrative value
  • Generates both human-readable narratives (stories.md, digest.md) and machine-readable indexes (index.json)
  • Redacts sensitive information while preserving traceable quotes for verification

Quick Start

Run the story-miner to process preprocessed data and write outputs to the default .story-miner directory.

Frequently Asked Questions about story-miner

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

FAQPage Schema
How do I extract publishable development stories from Claude Code session history?

To extract publishable development stories from Claude Code session history, this Skill mines preprocessed session data to assemble narratives with grounded quotes and provenance pointers. It scores candidates for narrative value and deduplicates similar incidents before generating the final story artifacts.

What is story mining in the context of Claude Code logs?

Story mining is the process of analyzing Claude Code session logs to produce publishable development narratives. It operates on preprocessed data files to extract grounded quotes, deduplicate incidents, and generate documentation suitable for onboarding and learning.

How do I convert Claude Code session logs into markdown documentation?

You can convert Claude Code session logs into markdown documentation by processing preprocessed data through the story mining pipeline. It outputs human-readable markdown files, specifically stories.md and digest.md, containing assembled narratives with provenance tracking.

Does the story mining process require any specific preprocessed data formats?

Yes, the story mining process requires specific preprocessed data formats to function correctly. It operates on preprocessed.json, candidates.jsonl, and stories.jsonl files to assemble narratives, score candidates, and deduplicate clusters before writing final output artifacts.

Can I redact sensitive information while preserving traceable quotes in development stories?

You can redact sensitive information while preserving traceable quotes in development stories using built-in redaction safeguards. The Skill ensures safe redaction of internal logs while maintaining provenance pointers that allow for quote verification and traceability.

What file outputs does the Claude Code story mining pipeline generate?

The Claude Code story mining pipeline generates both human-readable and machine-readable file outputs. It produces stories.md and digest.md for reading, alongside index.json, all written to the default .story-miner directory with full provenance tracking.