One-click install
npx skills add https://github.com/dongzhuoyao/deepresearch --skill sue-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sue-cleanup
Source: https://github.com/dongzhuoyao/deepresearch/tree/main/.codex/skills/sue-cleanup
Command: npx skills add https://github.com/dongzhuoyao/deepresearch --skill sue-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ssh, tmux, slurm, tar, flock.

What problem does it solve?

This Skill solves the critical issue of inode exhaustion on shared parallel filesystems (such as LUMI Lustre and Snellius GPFS) caused by tens of thousands of small output files generated during ML/HPC scale-up experiments, which can block new runs and disrupt team workflows.

Core Features & Use Cases

  • Safe Bulk Archiving: Archives only high-inode, already-summarized bulk output directories (images, benchmarks, legacy outputs) after verifying all metrics are extracted into reports and ledgers, never touching critical artifacts like checkpoints, logs, or readiness stamps.
  • Sandbox-Scoped Operations: Operates exclusively on a single selected sandbox backend's workspace output tree, avoiding unintended project-wide or multi-workspace deletions.
  • Use Case: After completing a full training run on LUMI that generated 18,000 per-variant image files, use this Skill to archive the image directory into a single tar file, freeing up nearly 18,000 inodes while preserving all benchmark reports and progress CSVs needed for result summarization.

Quick Start

Invoke the sue-cleanup skill after a dryrun or fullrun completes to archive high-inode bulk output directories from your sandbox-scoped experiment workspace, ensuring all benchmark reports, ledgers, and checkpoints are preserved for downstream processing.

Frequently Asked Questions about sue-cleanup

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

FAQPage Schema
How do I free up inodes on a shared parallel filesystem after ML scale-up experiments?

To free up inodes on shared parallel filesystems, you can archive high-inode bulk output directories into tar files. This skill safely compresses already-summarized experiment outputs while preserving critical artifacts like checkpoints and logs on platforms like LUMI and Snellius.

What is the best way to archive experiment outputs without losing downstream-critical artifacts?

The best way to archive experiment outputs without losing critical artifacts is to use a sandbox-scoped archiving workflow that verifies all metrics are extracted first. It strictly preserves reports, progress CSVs, logs, checkpoints, and readiness stamps during the tar compression process.

Does this inode cleanup workflow support both tmux and Slurm execution models for remote archiving?

Yes, this inode cleanup workflow supports both tmux and Slurm execution models for long-running remote archive operations. It operates exclusively on scoped single-workspace output trees across sandbox backends like LUMI, Snellius, Brev, AutoDL, and RunPod.

Can I use this archiving process across multiple sandbox workspaces at once?

No, you cannot use this archiving process across multiple sandbox workspaces simultaneously. It operates exclusively on a single selected sandbox backend's workspace output tree to avoid unintended project-wide or multi-workspace modifications during the inode conservation process.

When should I run the sandbox cleanup workflow during my HPC experiment lifecycle?

You should run the sandbox cleanup workflow immediately after a dryrun or fullrun completes. This ensures all benchmark reports, ledgers, and checkpoints are fully generated and preserved for downstream processing before high-inode bulk output directories are archived.

Why does archiving bulk output directories help with inode exhaustion on Lustre or GPFS filesystems?

Archiving bulk output directories helps with inode exhaustion on Lustre or GPFS filesystems because it consolidates tens of thousands of small output files generated during ML experiments into a single tar file, freeing up massive amounts of inodes while maintaining data integrity.