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.