skills.rest
zapabob
zapabobCOMMUNITY
Explore all skills by this author →
𝕏@zapabob_oujGitHub

specstory-organize

Organize SpecStory session markdown files into year and month subdirectories.

2|Updated Mar 10, 2026
Search Tags:#automation#file management#organization#scripting#ai history#specstory
One-click install
npx skills add https://github.com/zapabob/Skills --skill specstory-organize
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: specstory-organize
Source: https://github.com/zapabob/Skills/tree/main/registry/skills/specstory-organize/variants/cursor
Command: npx skills add https://github.com/zapabob/Skills --skill specstory-organize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the issue of cluttered .specstory/history directories by automatically organizing session files into a structured, date-based folder system.

Core Features & Use Cases

  • Automated Organization: Moves markdown files into YYYY/MM/ subdirectories based on filename timestamps.
  • Date Extraction: Parses dates from filenames like YYYY-MM-DD_HH-MM-SSZ-description.md.
  • Dry Run Mode: Allows users to preview changes before execution.
  • Use Case: Keep your AI coding session history clean and easily searchable by automatically sorting past conversations into monthly archives.

Quick Start

Run the command to organize your specstory history files.

Frequently Asked Questions about specstory-organize

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

FAQPage Schema
How do I organize SpecStory AI history files into subdirectories?▼

To organize SpecStory AI history files, this skill parses date information from markdown filenames and moves them into structured year and month-based subdirectories within your project directory.

How does automated file management work for AI coding session history?▼

Automated file management for AI coding session history works by extracting timestamps from filenames formatted like YYYY-MM-DD_HH-MM-SSZ-description.md and relocating the files into YYYY/MM/ archive folders.

Can I preview file organization changes before moving markdown files?▼

Yes, you can preview file organization changes before moving markdown files by using the skill's built-in dry-run mode, which simulates the directory sorting without executing actual file operations.

What is the best way to sort cluttered AI history directories by date?▼

The best way to sort cluttered AI history directories by date is to use an automated scripting approach that reads filename timestamps and archives markdown files into structured monthly folders.

Do I need specific dependencies to automate markdown file organization?▼

No, you do not need specific dependencies to automate markdown file organization, as this skill operates independently without external requirements to sort your SpecStory history files.

Related Skills

Explore More Software Engineering Skills→
pixbpixb

pix-chat-save

Save chat conversations to timestamped Markdown files in a chat-history directory.

Community
Basic
masseatermasseater
2

progress-files

Read past progress files to resume work across sessions.

Community
Basic
CaptainCrouton89CaptainCrouton89
497

Writing Slash Commands

Create custom slash commands with arguments, frontmatter, and Bash integration.

Community
Basic
hackethacket
38

obsidian-wikilinks-converter

Convert Obsidian WikiLinks to GitHub-compatible Markdown links.

Community
Intermediate