Specstory Organize

If you're using SpecStory AI and your .specstory/history folder is getting cluttered with dozens or hundreds of session markdown files, this skill sorts them into year/month subdirectories based on the timestamps in their filenames. Just say "organize my history" and it scans for files like 2026-01-22_19-20-56Z-fix-bug.md and moves them into folders like 2026/01/. It includes a dry run flag so you can preview what gets moved before committing. The script is straightforward Python that parses dates from filenames and creates the folder structure. Nothing fancy, but after a few months of sessions you'll appreciate having them organized by date instead of scrolling through a flat list of files.

skills.sh installs: 289
GitHub stars: 35
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add specstoryai/agent-skills --skill specstory-organize --agent claude-code

Installs into .claude/skills of the current project.

Files

SpecStory Organize

Organizes your .specstory/history directory by moving session files into YYYY/MM/ subdirectories based on the timestamp in each filename.

How It Works

Scans .specstory/history/ for markdown files
Extracts the date from filenames (e.g., 2026-01-22_19-20-56Z-fix-bug.md)
Creates year/month folders (e.g., 2026/01/)
Moves files into the appropriate subdirectory
Reports what was moved

Why Organize?

Over time, your history directory can accumulate hundreds of session files. Organizing by date makes it easier to:

Find sessions from a specific time period
Archive old sessions
Keep your project directory clean

Usage

Slash Command

User says	Action
`/specstory-organize`	Organize all files (default)
`/specstory-organize dry run`	Preview changes without moving
`/specstory-organize --dry-run`	Preview changes without moving

Direct Script Usage

# From project root
python skills/specstory-organize/scripts/organize.py

# Preview what would be moved (no changes made)
python skills/specstory-organize/scripts/organize.py --dry-run