Does it work with files already in subdirectories?

The script is designed to skip files that have already been organized into subdirectories, preventing redundant operations.

Is Python required to run this skill?

Yes, the skill utilizes a Python script to perform the file parsing and organization, compatible with most standard Python environments.

What happens if a file doesn't have a date in the name?

Files without a recognizable date pattern are safely skipped and left in their original location to prevent incorrect sorting.

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

Yes, you can use the '/specstory-organize dry run' command to preview the proposed changes without actually moving any files.

Does this skill delete any of my session files?

No, the skill only moves files into subdirectories based on their timestamps; no content is deleted during the organization process.

SpecStory History Organizer

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

byorganvm-iv-taxis

•

Productivity & Workflow

Automates the organization of SpecStory AI coding session files into date-based subdirectories to maintain a clean project structure.

The SpecStory History Organizer is a specialized utility designed to prevent project clutter by systematically sorting SpecStory session files. It scans the .specstory/history directory, extracts date information from file timestamps, and moves markdown files into nested year and month folders (e.g., 2024/05/). This skill is essential for developers using SpecStory who want to maintain an accessible, chronological archive of their AI-assisted coding sessions without manual file management or repository bloat.

Key Features

01Compatibility with both Python 2.7 and 3.x

02Hierarchical folder creation (YYYY/MM/)

03Dry-run mode for previewing changes

042 GitHub stars

05Detailed summary reports of moved files

06Automated date extraction from filenames

Use Cases

01Cleaning up a cluttered .specstory/history directory after intensive development

02Archiving old AI coding sessions to improve repository navigation

03Locating specific historical coding sessions by date

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