← Back to Skills Marketplace
Obsidian Organizer
by
Tony Simons
· GitHub ↗
· v1.0.0
949
Downloads
0
Stars
14
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-organizer
Description
Organize and standardize Obsidian vaults for reliability and long-term maintainability. Use when designing or cleaning vault folder structure, enforcing file...
README (SKILL.md)
Obsidian Organizer
Use this skill to make a vault predictable, searchable, and low-maintenance.
Workflow
-
Snapshot current state
- Count files and top-level folders.
- Identify naming drift and duplicate patterns.
-
Apply standard structure
- Read
references/folder-structure.md. - Propose moves before applying.
- Read
-
Enforce naming rules
- Read
references/naming-rules.md. - Run audit script in dry-run mode:
python scripts/obsidian_audit.py \x3Cvault-path>
- Apply only after confirmation:
python scripts/obsidian_audit.py \x3Cvault-path> --apply
- Read
-
Run migration checklist
- Follow
references/migration-checklist.mdin order.
- Follow
-
Verify
- Re-run audit until zero naming issues.
- Confirm daily notes use
YYYY-MM-DD.md. - Confirm no orphaned notes remain in
inbox/.
Guardrails
- Never rename or move files without a dry-run first.
- Never delete notes automatically.
- Prefer deterministic naming over clever naming.
- Keep folder depth shallow (\x3C=3 when possible).
- If link integrity is uncertain, pause and ask before bulk apply.
Usage Guidance
This skill appears to do exactly what it claims: audit and optionally rename markdown files in an Obsidian vault. Before running with --apply, make a full backup of your vault and review the printed rename plan from the dry-run. Be aware renames may break Obsidian internal links — follow the checklist to fix links (the skill does not update links automatically). Also, double-check the vault path you pass to the script to avoid accidental changes outside the intended directory; the script skips non-.md files, reserved filenames, and existing-target conflicts but will rename anything under the resolved path that matches its rules.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-organizer
Version: 1.0.0
The skill bundle is benign. The `SKILL.md` provides clear instructions and guardrails for the agent, explicitly stating the purpose of organizing Obsidian vaults and requiring dry-runs before applying changes. The `scripts/obsidian_audit.py` script performs file auditing and renaming using safe `pathlib.Path` operations, without any network calls, data exfiltration, or attempts at persistence. It also correctly ignores OpenClaw's internal agent files (`MEMORY.md`, `SOUL.md`, etc.), preventing accidental modification of agent state.
Capability Assessment
Purpose & Capability
Name, description, reference docs, SKILL.md workflow, and the included Python audit script all align: they audit and optionally rename markdown files to a deterministic naming scheme for an Obsidian vault. No unrelated credentials, binaries, or external services are requested.
Instruction Scope
Runtime instructions are limited to reading the included reference docs, running the audit script on a user-supplied vault path (dry-run by default), following a migration checklist, and manually fixing links. The script operates only on local files under the provided path and does not read other environment variables or send data externally. Note: the script performs recursive renames across the supplied path, so supplying the wrong path could affect unintended files — the SKILL.md correctly emphasizes dry-runs and backups.
Install Mechanism
No install mechanism is provided (instruction-only with a small included script). No downloads or third-party package installs are required.
Credentials
The skill requires no environment variables, credentials, or config paths. This is proportionate to its stated function of local file auditing and renaming.
Persistence & Privilege
The skill is not forced-always and does not request persistent presence or modify other skills or system-wide settings. It can be invoked by the agent (normal default) but has no autonomous persistence requirements.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-organizer - After installation, invoke the skill by name or use
/obsidian-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: deterministic Obsidian vault organization, naming audit script, migration checklist, and folder taxonomy standards.
Metadata
Frequently Asked Questions
What is Obsidian Organizer?
Organize and standardize Obsidian vaults for reliability and long-term maintainability. Use when designing or cleaning vault folder structure, enforcing file... It is an AI Agent Skill for Claude Code / OpenClaw, with 949 downloads so far.
How do I install Obsidian Organizer?
Run "/install obsidian-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Organizer free?
Yes, Obsidian Organizer is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Obsidian Organizer support?
Obsidian Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Organizer?
It is built and maintained by Tony Simons (@asimons81); the current version is v1.0.0.
More Skills