Does this skill delete any of my session files?

No, the SpecStory History Organizer only moves files into subdirectories; it does not delete or modify the content of your session files.

How does the skill know which date to use for sorting?

The skill parses the timestamp directly from the standard SpecStory filename format (e.g., 2026-01-22) rather than relying on file modification dates which can be unreliable.

Will it move files that are already organized?

No, the script is designed to recognize files already located in subdirectories and will skip them to avoid redundant processing.

Can I see what will happen before the files are moved?

Yes, you can use the 'dry run' argument to preview exactly which files will be moved and where, without applying any actual changes to your file system.

SpecStory History Organizer

Name: SpecStory History Organizer
Author: organvm-iv-taxis

byorganvm-iv-taxis

•

生产力与工作流

Organizes SpecStory AI coding session files into date-based subdirectories to maintain a clean and navigable project structure.

This skill automates the management of AI-generated session history within the SpecStory environment by scanning the .specstory/history directory and sorting markdown files into chronological year and month folders. By parsing timestamps directly from filenames, it prevents directory clutter, simplifies the retrieval of past coding sessions, and facilitates easier archiving without the need to manually manage hundreds of individual files. It is an essential utility for developers using SpecStory who want to maintain long-term project organization and audit trails.

主要功能

01Dry-run mode to preview organization changes without moving files

02Filename-based timestamp parsing for accurate chronological sorting

03Automated date-based folder creation (YYYY/MM)

042 GitHub stars

05Native integration with Claude Code via simple slash commands

06Detailed reporting and summary statistics of organized files

使用场景

01Quickly locating specific coding sessions from a previous month or year

02Cleaning up cluttered project directories containing hundreds of old AI session logs

03Preparing project history for archiving or long-term repository maintenance

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add organvm-iv-taxis/a-i--skills specstory-organize

For use in Claude.ai and ChatGPT

Download Skill