paulrberg/todo-archive
skills/todo-archive/SKILL.md
Use only when explicitly asked to archive/prune/compact/roll over checked tasks from TODO.md into `.ai/todos/TODO_UNTIL_YYYY_MM_DD.md`, leaving unchecked tasks.
$ install --global
skillsauthnpx skillsauth add paulrberg/dot-agents todo-archiveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 13, 2026, 6:23 AM146.1s3 files scanned
SKILL.md
- argument-hint:
- [path] [--date YYYY-MM-DD|YYYY_MM_DD] [--dry-run] [--force]
- disable-model-invocation:
- false
- name:
- todo-archive
- user-invocable:
- true
- description:
- Use only when explicitly asked to archive/prune/compact/roll over checked tasks from TODO.md into `.ai/todos/TODO_UNTIL_YYYY_MM_DD.md`, leaving unchecked tasks.
TODO Archive
Archive checked Markdown task-list items from TODO.md into .ai/todos/TODO_UNTIL_YYYY_MM_DD.md, then leave only unchecked tasks in TODO.md.
Arguments
path(optional): Repository root or any path inside the repository. Default to the current directory.--date YYYY-MM-DD|YYYY_MM_DD(optional): Archive date. Default to today's local date.--dry-run(optional): Preview target paths and rendered content without writing.--force(optional): Allow overwriting an existing archive file.
Workflow
-
Resolve the repository root:
git rev-parse --show-toplevelIf the command fails, use the provided
pathor current directory as the root. -
Verify
TODO.mdexists at the root. If it is missing, stop and report the path checked. -
Run the helper from this skill directory:
uv run python scripts/archive_todo.py --root "$repo_root"Pass through
--date,--dry-run, or--forcewhen the user requested them. -
Report the rewritten
TODO.md, the created archive path, and the checked/unchecked task counts. If the helper reports no checked tasks, treat it as a no-op. -
If useful, inspect only the touched paths:
git diff -- TODO.md .ai/todos/
Helper Behavior
scripts/archive_todo.py:
- Reads only
<root>/TODO.md. - Writes checked tasks to
<root>/.ai/todos/TODO_UNTIL_YYYY_MM_DD.md. - Rewrites
<root>/TODO.mdwith unchecked tasks. - Preserves non-task content inside any heading subtree that still has tasks for the output.
- Drops headings whose subtree has no tasks for the output.
- Keeps nested parent items as plain bullets when only descendants match the output, avoiding orphaned subtasks without copying the wrong checkbox state.
- Leaves a minimal
# TODOstub when every task was archived. - Refuses to overwrite an existing archive unless
--forceis passed.
Related Skills
paulrberg/update-skills
testing
VerifiedTrustedCommunity
Use ONLY to check or update the project-scoped agent skills installed under .agents/skills so they match the current state of the repo. Do not trigger for creating, finding, or installing skills, or for README/AGENTS.md updates.
4SKILL.mdUpdated Jun 13, 2026
paulrberg/spreadsheets
testing
VerifiedTrustedCommunity
Use when CSV, TSV, or Excel (.xlsx) is the primary input/output: inspect, clean, transform, dedupe, merge, validate, convert, recalc formulas, or create/fix spreadsheets. Do not trigger when tabular data is incidental.
4SKILL.mdUpdated Jun 13, 2026
paulrberg/xlsx
development
VerifiedTrustedCommunity
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.
4SKILL.mdUpdated Jun 7, 2026
paulrberg/pdf
content-media
VerifiedTrustedCommunity
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
4SKILL.mdUpdated Jun 7, 2026