todo-archive

Archive completed TODO.md tasks into monthly YYYY-MM.md files with backups.

8|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill todo-archive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo-archive
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/productivity/todo-archive
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill todo-archive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, bash>=4, tools/todo-engine.py.

What problem does it solve?

Completed and cancelled tasks accumulate in a single TODO.md HISTORY section and eventually exceed practical size limits, causing loss of operational history and making long-term search and accountability difficult.

Core Features & Use Cases

  • Parses the HISTORY section of a TODO.md file to identify completed and cancelled tasks using Done/Cancelled dates.
  • Partitions archived tasks into monthly satellite files named YYYY-MM.md inside a todo-archives directory and appends under date headers while avoiding duplicates.
  • Rebuilds TODO.md safely with backups and persistent shadow copies, updates a todo-archives/INDEX.md manifest, and provides search and stats utilities for archived tasks.
  • Use cases: routine housekeeping when TODO.md grows large, forced archival of old history, searching past work by keyword or issue ID, and generating monthly archive summaries.

Quick Start

Run the archive routine to move completed tasks from your TODO.md into monthly archive files while creating backups and verifying integrity.

Frequently Asked Questions about todo-archive

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

FAQPage Schema
How do I archive completed tasks from a TODO.md file into monthly files?

To archive completed tasks from a TODO.md file, this Skill parses the HISTORY section, groups Done and Cancelled entries by month into YYYY-MM.md files, updates an INDEX.md manifest, and safely rewrites the canonical TODO.md with verified integrity and backups.

What is the best way to prune a large HISTORY section in a markdown task list?

Pruning a large HISTORY section in a markdown task list is handled by partitioning completed and cancelled entries into monthly archive files, preventing uncontrolled size growth while preserving operational history and maintaining long-term searchability.

Does archiving TODO.md history support idempotency and backups?

Yes, archiving TODO.md history supports idempotency and backups by creating persistent shadow copies, avoiding duplicate entries in monthly files, and verifying integrity before replacing the canonical TODO.md file.

Can I search archived TODO entries by keyword or issue ID after moving them?

Yes, you can search archived TODO entries by keyword or issue ID using built-in search and stats utilities that query the generated monthly YYYY-MM.md satellite files and the INDEX.md manifest.

Do I need Python3 and Bash to run the TODO.md archival process?

Yes, you need Python3 and Bash 4 or higher to run the TODO.md archival process, as the automation relies on the todo-engine.py tool and shell scripting to parse, partition, and rewrite task files.

Why does my TODO.md file lose operational history when it gets too large?

A TODO.md file loses operational history when it gets too large because practical size limits make long-term accountability difficult; archiving completed tasks into monthly YYYY-MM.md files solves this by preserving searchable records externally.