issues-purge

Remove closed .toml issue files and commit the purge.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/glhewett/public-skills --skill issues-purge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issues-purge
Source: https://github.com/glhewett/public-skills/tree/main/issues-purge
Command: npx skills add https://github.com/glhewett/public-skills --skill issues-purge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Removes stale closed issues that remain as .toml files in the repository, preventing clutter and keeping the issue tracker and git history consistent.

Core Features & Use Cases

  • Discovery: Finds all .issues/*.toml files using globbing and reads their contents.
  • Filtering: Parses TOML to identify issues with closed = true and surfaces their IDs and titles for review.
  • Safe Removal: Presents the list for user confirmation, runs git rm on each confirmed file, and commits a single purge commit with the removed IDs.
  • Use Case: Ideal for small projects or solo contributors using a file-based issue tracker who want to batch-remove closed issues and record the purge in git history.

Quick Start

Run the issues-purge skill to locate closed .toml issue files, confirm deletion, and commit their removal from the repository.

Frequently Asked Questions about issues-purge

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

FAQPage Schema
How do I batch delete closed issues stored as TOML files in my git repository?

To batch delete closed issues stored as TOML files, the skill glob-scans .issues/*.toml, parses for closed = true, runs git rm on matches, and commits a single purge message to keep git history consistent.

What is the best way to clean up stale issue files without losing git tracking history?

The best way to clean up stale issue files without losing tracking is running git rm on closed TOML files and consolidating removals into a single purge commit, preserving repository consistency and traceability.

Can I automatically find and remove closed issues in a file-based tracker?

Yes, you can automatically find and remove closed issues in a file-based tracker by globbing .issues/*.toml, parsing TOML to detect closed = true, and executing git rm for confirmed deletions.

Does the issue purge workflow require manual confirmation before deleting files?

Yes, the issue purge workflow requires manual confirmation; it surfaces parsed issue IDs and titles for review before executing git rm and committing the consolidated removal message.

Is purging closed TOML issues suitable for large team repository workflows?

Purging closed TOML issues is designed for small projects or solo contributor workflows using file-based issue tracking, ensuring safe removal and git commits without overhead for large teams.