Agent skill

System Storage Cleanup

by vellum-ai in vellum-ai/vellum-assistant

Handle disk pressure, critically low storage, safe storage limits, and storage cleanup mode by inspecting disk usage and proposing safe cleanup steps.

MITAuto-check passed

Install System Storage Cleanup

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill system-storage-cleanup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant system-storage-cleanup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/assistant/src/config/bundled-skills/system-storage-cleanup .claude/skills/system-storage-cleanup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
system-storage-cleanup
GitHub stars
1.4k
Token cost
~1.2k tokens
SKILL.md length
590 words
Files
1
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Handle disk pressure, critically low storage, safe storage limits, and storage cleanup mode by inspecting disk usage and proposing safe cleanup steps.

  • SKILL.md covers Cleanup Contract, Inspection Procedure, SQLite Diagnosis Only and Safer Cleanup Candidates, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

System Storage Cleanup is an agent skill from vellum-ai/vellum-assistant. Handle disk pressure, critically low storage, safe storage limits, and storage cleanup mode by inspecting disk usage and proposing safe cleanup steps.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Vellum personal assistants

The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

  • “/system-storage-cleanup”

Requirements

  • Docker
  • Compatibility (from SKILL.md): Designed for Vellum personal assistants

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Vellum personal assistants

    From compatibility in the SKILL.md frontmatter.

Context cost

System Storage Cleanup loads about 1.2k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 590 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 590 words, ~1,242 tokens.

Download SKILL.mdSave it as .claude/skills/system-storage-cleanup/SKILL.md (or your agent's skills folder).
name
system-storage-cleanup
description
Handle disk pressure, critically low storage, safe storage limits, and storage cleanup mode by inspecting disk usage and proposing safe cleanup steps.
compatibility
Designed for Vellum personal assistants
metadata.emoji
🧹

You are operating under a critical storage cleanup contract. Your only goal is to free enough storage for the assistant to resume normal work without damaging user data.

Cleanup Contract

Start by warning the user that storage is critically low and normal work is suspended until storage cleanup mode clears. Stay scoped to freeing storage until the disk-pressure lock clears or the guardian explicitly overrides it.

Prefer foreground inspection with available cleanup-safe tools before any mutation. Identify both the target volume that is actually full and the workspace path before proposing deletions. Do not work on unrelated tasks, refactors, installs, upgrades, or product changes while the storage lock is active.

Ask for explicit approval before deleting files, caches, logs, package caches, Docker artifacts, or any other data unless the user has already approved that exact action. Before asking, present each proposed deletion with:

  • Exact path or artifact name.
  • Estimated reclaimable size.
  • Expected consequence, including whether it is regenerable or may remove user-visible history.

If the user approves a broad category, narrow it to exact paths or artifacts before deleting. If the user approves one exact path, do not treat that as approval for adjacent paths.

Never delete credentials, security material, workspace database files, config files, active profiler runs, migrations, skill source, app source, conversation records, memory graph nodes or segments, journal/, data/reflections/, PKB files, backups, or backup keys unless the user explicitly names that path and accepts the consequence.

Inspection Procedure

Use local/container-visible inspection first. Prefer df -h on the current workspace path and on VELLUM_WORKSPACE_DIR when that variable is available. In Docker/container mode, /workspace is the persistent volume and cleanup should normally focus there.

Use du one level at a time and sort by size to identify large directories before drilling deeper. Keep each pass readable and bounded to the volume or workspace that is actually full. Avoid whole-filesystem scans unless the target volume cannot be isolated.

Use host_bash only when the sandbox cannot see the volume that is actually full and host-level inspection is necessary. Explain why host-level inspection is needed before using it.

Show full SKILL.md (244 more words)Show less

SQLite Diagnosis Only

If data/db/assistant.db dominates disk usage, inspect it only through read-only sqlite3 access. Diagnostics may use PRAGMA and SELECT queries for:

  • page_size
  • page_count
  • freelist_count
  • dbstat object-size breakdowns

The purpose is to determine whether growth comes from specific tables/indexes or from free-page bloat. Do not edit the database manually.

Never run ad hoc DELETE, UPDATE, INSERT, DROP, REINDEX, schema changes, VACUUM, PRAGMA writable_schema, or any other mutating SQLite command from this skill. If SQLite tables are the main culprit, tell the user this needs product-owned retention or maintenance work rather than manual database editing.

Safer Cleanup Candidates

Good candidates to inspect and propose, when they are clearly nonessential and user-approved, include:

  • Scratch or temporary downloads created by the assistant.
  • Generated build artifacts.
  • Old logs.
  • Stale temporary directories.
  • Completed profiler runs that are no longer active.
  • Stale caches.
  • Large old diagnostic text attachments such as spindumps.
  • Package cache cleanup or Docker cache/artifact cleanup after the user approves the exact package manager or Docker action.

Treat source files, persistent records, and user-authored content as protected unless the user explicitly names them for deletion and accepts the consequence.

Non-Goals

ATL-450 product work is out of scope for this skill. Do not implement configurable trace or audit retention jobs, attachment retention or compression jobs, upload-time image re-encoding, first-class disk-usage UI, one-click cleanup buttons, or scheduled SQLite vacuuming. If inspection shows those are needed, report that as follow-up product work after the immediate storage cleanup path is safe.

© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in assistant/src/config/bundled-skills/system-storage-cleanup of vellum-ai/vellum-assistant.

Open the folder on GitHubat commit 33cc983

Compare with similar skills

System Storage Cleanup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

System Storage Cleanup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
System Storage Cleanup this skillvellum-ai/vellum-assistant1.4k—~1.2kAutomated safety check: PassMIT
Error Handlingaffaan-m/ECC277k1 repos~2.7kAutomated safety check: PassMIT
Disk Storage AnalyzerKKKKhazix/khazix-skills21k1 repos~1.4kAutomated safety check: PassMIT
Error Handlingthedaviddias/Front-End-Checklist74k—~416Automated safety check: PassMIT
Error Handlingaffaan-m/ECC276k—~2.4kAutomated safety check: PassMIT
Gke Storage Troubleshootinggoogle/skills21k—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Error Handling

    affaan-m/ECC

    Patterns for robust error handling across TypeScript, Python, and Go.

    277k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • Disk Storage Analyzer

    KKKKhazix/khazix-skills

    Scans a Mac or Windows PC read-only to find what fills the disk, grades each item by how safe it is to clean and builds an interactive HTML report.

    21k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • Error Handling

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Implement proper error handling.

    74k GitHub stars~416 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Error Handling

    affaan-m/ECC

    TypeScript、Python、Goにわたる堅牢なエラー処理のパターン。型付きエラー、エラー境界、リトライ、サーキットブレーカー、ユーザー向けエラーメッセージをカバーします。

    276k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Official

    Diagnoses GKE persistent-storage failures — volume attach/mount errors (Regional PD on optimized VMs, fsGroup mount timeouts), disk-performance and node storage-pressure issues, slow-disk…

    21k GitHub stars~3.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Cleanup

    simstudioai/sim

    Run all code quality skills — effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit — analyzing in parallel, then applying fixes sequentially

    30k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed

More from vellum-ai/vellum-assistant

All 108 skills in this repo
  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: warnings

Questions about System Storage Cleanup

What does System Storage Cleanup do?

Handle disk pressure, critically low storage, safe storage limits, and storage cleanup mode by inspecting disk usage and proposing safe cleanup steps. System Storage Cleanup is an agent skill from vellum-ai/vellum-assistant. Handle disk pressure, critically low storage, safe storage limits, and storage cleanup mode by inspecting disk usage and proposing safe cleanup steps.

How do I install System Storage Cleanup in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill system-storage-cleanup -a claude-code`. Or copy the skill folder (assistant/src/config/bundled-skills/system-storage-cleanup in vellum-ai/vellum-assistant) into .claude/skills/system-storage-cleanup in your project. Claude Code loads it when a task matches its description.

How do I install System Storage Cleanup in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill system-storage-cleanup -a codex`. Or copy the skill folder (assistant/src/config/bundled-skills/system-storage-cleanup in vellum-ai/vellum-assistant) into .agents/skills/system-storage-cleanup in your project. Codex loads it when a task matches its description.

Can I use System Storage Cleanup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill system-storage-cleanup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/system-storage-cleanup, .gemini/skills/system-storage-cleanup, .github/skills/system-storage-cleanup and .opencode/skills/system-storage-cleanup in your project.

What does System Storage Cleanup need to run?

SKILL.md names no scripts, command-line tools or credentials: System Storage Cleanup is instructions for the agent only. Our summary lists: Docker. Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does System Storage Cleanup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is System Storage Cleanup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does System Storage Cleanup use?

System Storage Cleanup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does System Storage Cleanup use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to System Storage Cleanup?

Skills that share tags, products or a category with System Storage Cleanup: Error Handling (affaan-m/ECC, 277k stars), Disk Storage Analyzer (KKKKhazix/khazix-skills, 21k stars), Error Handling (thedaviddias/Front-End-Checklist, 74k stars) and Error Handling (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains System Storage Cleanup?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.