cleanup-studio

Scan note vaults for stubs, oversized notes, duplicates, and stale attachments.

1|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/KevinBean/emptyos --skill cleanup-studio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cleanup-studio
Source: https://github.com/KevinBean/emptyos/tree/main/skills/vault-cleanup-studio
Command: npx skills add https://github.com/KevinBean/emptyos --skill cleanup-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vault hygiene issues accumulate in long-form vaults. This tool scans your vault to surface stubs, oversized notes, duplicates, and stale attachments and presents checks with explicit user consent requirements.

Core Features & Use Cases

  • Read-only analysis: never auto-fixes, always asks for permission.
  • Scans for stubs, huge notes, duplicates, stale attachments.
  • Generates actionable reports to review before deletions or moves.
  • Use during weekly vault hygiene reviews to keep content tidy.

Quick Start

From your vault root, run the Python script 99_Attachments/scripts/cleanup-studio.py to generate a report of issues, then review results before taking any action.

Frequently Asked Questions about cleanup-studio

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

FAQPage Schema
How do I find duplicate notes and stale attachments in my vault?▼

To find duplicate notes and stale attachments, run a vault hygiene scan to surface these issues alongside oversized notes and stubs. The analyzer operates in read-only mode to safely report problems before any changes.

What is the best way to audit vault hygiene without accidentally deleting files?▼

The best way to audit vault hygiene safely is using a read-only analyzer that surfaces issues like duplicates and stubs. It always asks for user permission before taking any action, ensuring no files are accidentally deleted.

How do I scan for oversized notes and stubs during weekly vault maintenance?▼

You can scan for oversized notes and stubs during weekly vault maintenance by running a Python script from your vault root. This generates an actionable report to review before executing any moves or deletions.

Can I use a vault cleanup tool to analyze notes without modifying the original files?▼

Yes, you can use a vault cleanup tool that operates strictly in read-only mode. It analyzes your notes and attachments to identify duplicates and other issues, presenting a report without modifying your original files.

Does vault hygiene analysis require any external dependencies to run?▼

No, vault hygiene analysis requires no external dependencies to run. You simply execute the Python script directly from your vault root directory to generate a comprehensive report of your vault's issues.

When should I run a vault cleanup audit to surface stubs and stale attachments?▼

You should run a vault cleanup audit during weekly maintenance routines to surface accumulated stubs, duplicates, and stale attachments. This keeps your personal or team long-form vault content tidy before making changes.