Janitor

Delete stale .notify-*, .pending-notify-temp, and .outputs artifacts by TTL.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill janitor-atrium-hermes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Janitor
Source: https://github.com/Atrium-Hermes/atrium-lighthouse/tree/main/skills/janitor
Command: npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill janitor-atrium-hermes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Accumulates temporary and output artifacts from skill runs, including root-level .notify-* files, .pending-notify-temp/ artifacts, and stale .outputs/ chain artifacts. This skill cleans up these artifacts to prevent clutter, reduce noise, and mitigate accidental disclosure of old data.

Core Features & Use Cases

  • Automated cleanup of root-level .notify-* files older than 7 days.
  • TTL-based removal of .pending-notify-temp/ artifacts older than 7 days.
  • .outputs cleanup for chain artifacts older than 14 days.
  • Logging & optional notification of deletions to memory logs and notification queues.

Quick Start

Run the janitor skill to scan the repository and remove stale .notify-*, .pending-notify-temp/, and .outputs artifacts according to their TTLs.

Frequently Asked Questions about Janitor

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

FAQPage Schema
How do I automate cleanup of stale ephemeral files generated by recurring skill runs?

Automating stale ephemeral file cleanup involves scanning the repository and purging artifacts like .notify-* and .pending-notify-temp items. TTL-based checks remove root files older than 7 days and .outputs artifacts older than 14 days to prevent clutter.

What is the best way to remove stale .outputs artifacts from my repository?

The best way to remove stale .outputs artifacts is using TTL-based checks to delete chain artifacts older than 14 days. This scheduled maintenance task prevents accidental disclosure of old data while logging deletion results for audit trails.

Do I need a Node runtime to execute automated file cleanup scripts?

Yes, you need a Node runtime to execute the deletion script, perform TTL-based checks on artifacts, and log the cleanup results. This environment is required to scan and purge stale .notify-* and .outputs files.

How does TTL-based removal work for temporary notification artifacts?

TTL-based removal works by checking the age of .pending-notify-temp artifacts and permanently deleting them if they are older than 7 days. This mechanism ensures temporary notification artifacts do not accumulate during recurring skill runs.

Can I log deleted files for audit trails during repository cleanup?

Yes, you can log deleted files for audit trails by routing cleanup results to memory logs and notification queues. This records every purged .notify-* and .outputs artifact during the automated maintenance task.

Why does my repository keep accumulating .pending-notify-temp artifacts?

Repositories accumulate .pending-notify-temp artifacts when recurring skill runs generate temporary outputs without scheduled maintenance. Running an automated cleanup script applies TTL-based checks to purge these stale files and reduce noise.