Not in the top 1,000 by GitHub stars
Da7-Tech/storage-rescue
Agent Skill that frees up storage on a Mac without losing data: verified offload to an external drive, or safe cleanup with no drive. Asks before every deletion. Plain text, no runtime.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/storage-rescue/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 9c3082b06181
No earlier version was observed for comparison.
Heat
0.4- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- storage-rescue
skills/storage-rescue
How it works
storage-rescue
When your agent uses it
Free up storage on a Mac without losing data. Two modes - Offload (move files to an external drive, verified by checksum, then delete them from the Mac) and Reclaim (no drive; delete caches and things the user does not need). The agent asks the user before every move or deletion. Use when the user says the disk is full, wants to free space, asks what "System Data" is, wants to archive old projects, movies, models or backups to an external or NTFS drive, or wants a safe cleanup. macOS only.
What it loads into context
Frontmatter
145 tokensAlways available to the agent
SKILL.md
3,107 tokensWhen the skill is activated
Reference documents
14,298 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Non-negotiable rules
- Workflow
- Restoring an item later
- Common pitfalls
Files
LICENSEasset1,065 bytesSKILL.mdcore13,511 bytesSKILL.mdcore13,511 bytesSKILL.mdcore13,511 bytesSKILL.mdcore13,511 bytesSKILL.mdcore13,511 bytesSKILL.mdcore13,511 bytesSKILL.mdcore13,511 bytesreferences/app-data.mddoc4,396 bytesreferences/external-drives.mddoc7,698 bytesreferences/offload-protocol.mddoc31,648 bytesreferences/reclaim-catalog.mddoc9,636 bytesreferences/system-data.mddoc2,734 bytes
Read SKILL.md
# Storage Rescue
Free space on a Mac while guaranteeing that nothing the user still needs is lost. Two modes:
- **Offload mode**: the user has an external drive. Large, rarely used files are copied to the drive, verified byte for byte by reading them back from the drive, and only then deleted from the Mac.
- **Reclaim mode**: there is no drive. Nothing is moved; what goes is deleted. That covers caches and build output that programs regenerate, plus anything the user decides they no longer want. Personal files pass through the Trash first, and emptying it is the user's last confirmation.
The first question decides the mode: is there an external drive to move files to? Both modes can run in one session: offload the user's files, then reclaim caches.
**The user decides, the agent proposes.** Every move and every deletion is preceded by a question the user answered. The agent finds things, explains them, and asks; it never acts on its own judgment of what the user "obviously" does not need.
Load the reference that matches the step you are on:
| Reference | Load when |View the complete source on GitHubSkills included
- storage-rescue
Repository facts
- License
- MIT
- Created
- Oct 6, 2026
- Last pushed
- Oct 6, 2026
- Forks
- 2
- Open issues
- 0
- Project activity
- Active
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 4, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 6 notes
skills/storage-rescue/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/storage-rescue/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/storage-rescue/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/storage-rescue/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/storage-rescue/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/storage-rescue/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- 7 dangerous shell commandsin 4 files: storage-rescue/references/reclaim-catalog.md:48 storage-rescue/references/external-drives.md:43 storage-rescue/SKILL.md:152 and 1 more
- No network access
- 1 obfuscation signalin 1 file: storage-rescue/references/external-drives.md:109
- No instruction overrides
- No executable scripts
- 2 references to secretsin 2 files: storage-rescue/SKILL.md:39 storage-rescue/references/reclaim-catalog.md:104
- No requests to vote in Hot
Show all 10 signals by file
skills/storage-rescue/SKILL.md
skills/storage-rescue/references/external-drives.md
- Dangerous shell operationline 43
sudo anylinuxfs mount -r --ignore-permissions /dev/disk9s1 - Dangerous shell operationline 50
To cycle the mount between the copy phase and the re-verification phase: `anylinuxfs unmount /Volumes/<name> --wait-for-vm`, confirm it is gone with `mount | grep /Volumes/<name>`, then the user mounts it again with the same `sudo anylinuxf - Possible obfuscationline 109
if magic == b"\x00\x05\x16\x07":
skills/storage-rescue/references/offload-protocol.md
- Dangerous shell operationline 522
rm = os.rmdir if is_dir else os.unlink
skills/storage-rescue/references/reclaim-catalog.md
- Dangerous shell operationline 48
Use `find ... -mtime +N` with `-type f` for age-based cleanup, and print the count and total size before deleting. If the host blocks a broad `rm -rf` or `find -delete`, delete the exact listed paths with a short script instead of trying to - Dangerous shell operationline 60
| Local AI models | Ollama: `ollama list`; Hugging Face: `hf cache ls` (older installs: `huggingface-cli scan-cache`); LM Studio: its model manager | `ollama rm <model>`; `hf cache rm <id>` (older: `huggingface-cli delete-cache`); LM Studio - Dangerous shell operationline 63
| Time Machine local snapshots | `tmutil listlocalsnapshots /` | macOS deletes them when space is needed. To force it, the user runs `sudo tmutil deletelocalsnapshots <date>` | Loses local restore points | - Access to secretsline 104
[Credential-related source omitted]
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Signal confidence: 10 facts
- Access to secrets in prose of the SKILL.mdstorage-rescue/SKILL.md:39Low confidence
- Dangerous shell operation in prose of the SKILL.mdstorage-rescue/SKILL.md:152Low confidence
- Dangerous shell operation in code of documentationstorage-rescue/references/external-drives.md:43Low confidence
- Dangerous shell operation in prose of documentationstorage-rescue/references/external-drives.md:50Low confidence
- Possible obfuscation in code of documentationstorage-rescue/references/external-drives.md:109Low confidence
- Dangerous shell operation in code of documentationstorage-rescue/references/offload-protocol.md:522Low confidence
- Dangerous shell operation in prose of documentationstorage-rescue/references/reclaim-catalog.md:48Low confidence
- Dangerous shell operation in prose of documentationstorage-rescue/references/reclaim-catalog.md:60Low confidence
- Dangerous shell operation in prose of documentationstorage-rescue/references/reclaim-catalog.md:63Low confidence
- Access to secrets in prose of documentationstorage-rescue/references/reclaim-catalog.md:104Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md skills/storage-rescue/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md skills/storage-rescue/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/storage-rescue/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/storage-rescue/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/storage-rescue/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/storage-rescue/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.