Does this skill modify my existing source code?

No. Story Miner follows strict 'Prohibited Actions' rules, ensuring it never writes code files, creates temporary scripts, or modifies files outside its designated output directory.

Where are the generated stories stored?

By default, all artifacts including the Markdown stories and JSON summaries are saved in the .story-miner/ directory within your project.

How do I limit the history processed by the skill?

You can use the --since argument (e.g., /story-miner --since 7d) to only process logs modified within a specific timeframe like days, weeks, or hours.

Can I customize the story generation quality?

Yes, the skill includes 'self-test' and 'evolve' commands that allow you to evaluate prompt quality and propose automated improvements to the narrative generation logic.

Is Story Miner safe to use with private data?

Yes. It includes a mandatory scanning phase that identifies and redacts secrets, API keys, and PII from the output artifacts before they are finalized.

Story Miner

Name: Story Miner
Author: BryceEWatson

byBryceEWatson

0•

Learning & Documentation

Extracts and formats publishable development narratives and technical insights from Claude Code session history.

Story Miner is an advanced utility for developers using Claude Code who want to capture the narrative arc of their development process. It scans local session logs to detect high-value signals—such as architectural shifts, debugging breakthroughs, and significant commits—transforming them into polished, human-readable stories. By leveraging intelligent sampling and grounded evidence, it creates content suitable for technical blogs, internal documentation, or project digests while strictly adhering to security protocols to redact sensitive information and maintain local-only operations.

Key Features

01Signal-based detection of architectural decisions and debugging breakthroughs

02Automated security scanning for secrets, API keys, and PII redaction

03Intelligent log sampling and content truncation to manage large sessions

040 GitHub stars

05Incremental processing support to track only new session activity

06Narrative-driven story generation featuring direct session quotes

Use Cases

01Creating post-mortems for complex debugging and troubleshooting sessions

02Generating internal project digests and engineering decision records

03Automating 'Build in Public' updates for social media or technical blogs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bryceewatson/bryce-labs-toolkit story-miner

For use in Claude.ai and ChatGPT

Download Skill