Obsidian Cleaner
v1.0.0Automatically clean up loose images and attachments in Obsidian vault root, moving them to the Attachments folder. Trigger when user says "clean obsidian", "clean attachments", or "整理附件".
⭐ 0· 781·1 current·1 all-time
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Suspicious
medium confidencePurpose & Capability
Name, description, SKILL.md, and the Python script all agree the tool scans an Obsidian vault root and moves loose attachment files into an Attachments folder. The code is consistent with that stated purpose and requires no external credentials, network access, or install steps. However, the code's supported-extension set is broader than the SKILL.md example list (code includes .md and .txt and .doc), which is a surprising capability for an 'attachments cleaner'.
Instruction Scope
SKILL.md describes scanning and moving images and attachments and documents .png/.jpg/.gif/.jpeg/.webp/.pdf/.docx, but the actual script also considers .md, .txt and .doc as supported extensions and will move those files from the vault root. Moving .md files could relocate actual notes, which is a high-impact side effect users likely do not expect. The instructions do provide a --dry-run option, but the doc omission of .md/.txt is an instruction–implementation mismatch that could cause data movement the user didn't anticipate.
Install Mechanism
There is no install spec or network/downloads; this is an instruction-only skill with a bundled Python script. That minimizes supply-chain risk. The script uses only standard library modules (os, shutil, argparse, pathlib, datetime).
Credentials
The skill requests no environment variables, credentials, or config paths. It operates on a user-specified filesystem path (default: ~/Documents/Obsidian Vault), which is appropriate for its purpose.
Persistence & Privilege
The skill is not set to always:true and does not request persistent system-wide privileges or modify other skills. It runs locally when invoked and prints reports; no autonomous or persistent behavior beyond normal invocation.
What to consider before installing
This tool otherwise appears coherent and local-only, but there is a notable mismatch: the SKILL.md examples list image/document extensions, while the script will also treat .md and .txt as attachments and move them from the vault root. Before installing or running: 1) Inspect the Python file yourself (it is included) and confirm the SUPPORTED_EXTENSIONS list is appropriate for your vault; remove .md/.txt if you don't want notes moved. 2) Always run with --dry-run first to review what would be moved. 3) Back up your vault (or run the script on a copy) before any real run. 4) Note the default vault path (~/Documents/Obsidian Vault) — pass --vault if your vault is elsewhere. If you want further help, I can produce a patched version that excludes .md/.txt or add additional safety checks (e.g., only move image mime types or prompt for each file).Like a lobster shell, security has layers — review code before you run it.
latestvk9783jgabs8d3gwrcb5b2n4phn811jzt
License
MIT-0
Free to use, modify, and redistribute. No attribution required.