obsidian-cleaner

What This Skill Does

The obsidian-cleaner skill serves as an automated housekeeper for your Obsidian vault. Many users accumulate loose images, PDFs, and document files in their vault root, which quickly leads to a cluttered directory structure. This skill intelligently scans the vault root for common media and document formats—such as PNG, JPG, GIF, WebP, PDF, and DOCX—and systematically moves them into a dedicated 'Attachments' folder. If that folder does not exist, the skill will create it automatically, ensuring your root directory remains focused on your markdown notes. It includes safety features like a 'dry run' mode, allowing you to preview changes before they happen to avoid accidental file mismanagement.

Installation

To integrate this utility, ensure you have the OpenClaw framework installed. Run the following command in your terminal: clawhub install openclaw/skills/skills/sparkingskin-tech/obsidian-cleaner Once installed, the agent will recognize the relevant triggers and be able to execute cleanup tasks locally on your vault path.

Use Cases

This skill is perfect for users who frequently copy-paste images or screenshots into their notes, which often results in cluttering the root folder. It is ideal for periodic maintenance, such as during a weekly review or when preparing to archive notes. It is particularly useful for users with large vaults who find it difficult to locate important markdown files amidst hundreds of media assets.

Example Prompts

1. "Clean up my Obsidian vault, there are images everywhere."
2. "I've got a lot of loose files in my root folder, please run the clean attachments skill."
3. "整理附件 - 帮我把所有图片都移动到附件文件夹里。"

Tips & Limitations

• Safety First: The skill is designed for safety; it does not delete files, only relocates them. If a file with the same name already exists in the target folder, the skill will skip it to prevent data loss.
• Path Customization: By default, the skill targets '~/Documents/Obsidian Vault'. If your vault is located elsewhere, you can override this by passing the --vault flag.
• Dry Run: Always perform a dry run (--dry-run) the first time you run this in a large, complex vault to verify the target structure meets your expectations.
• Limitations: While it moves common file types, it does not currently update internal markdown link references (like ![[image.png]]), so be aware that if your note references were hardcoded, they may need updating.