Obsidian Skills (kepano)

Name: Obsidian Skills (kepano) (Claude Skill)
Author: kepano

Why use it

Key features

Markdown conventions actual Obsidian users follow
Bases (Obsidian 1.10+) — schema-defined collections
JSON Canvas — visual maps of notes
Obsidian CLI patterns for batch operations
Property/frontmatter idioms

Live Demo

What it looks like in practice

ready

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use Obsidian Skills (kepano)

Clean up a messy Obsidian vault with consistent properties

👤 Long-time Obsidian users ⏱ ~60 min intermediate

When to use: Years of notes — inconsistent tags, properties, file naming.

Prerequisites

Obsidian vault path — Point the skill at it

Flow

Audit

Use obsidian-skills. Audit /vault — list inconsistencies in properties, dead links, orphan notes.✓ Copied

→ Issue inventory
Normalize

Migrate tag: to YAML tags: properties consistently.✓ Copied

→ Diffs across affected notes
Verify

Re-audit. Confirm orphans have homes and properties are consistent.✓ Copied

→ Clean audit

Outcome: Vault that searches and links cleanly.

Pitfalls

Bulk edits break plugins — Test on a backup copy first; the skill suggests this

Combine with: filesystem

Convert a folder of notes into an Obsidian Base

👤 Users adopting Bases for project tracking ⏱ ~45 min intermediate

When to use: You want a typed view over your project notes.

Flow

Schema

Look at /vault/projects. Propose a Base schema — properties, types, defaults.✓ Copied

→ Schema spec
Migrate

Update each project note to conform. Backfill defaults where missing.✓ Copied

→ Notes conform; Base view works

Outcome: Working Base; you can sort, filter, group your projects.

Pitfalls

Property type mismatches — Skill validates types — fix flagged notes before the Base loads cleanly

Generate a JSON Canvas of related notes for a topic

👤 Researchers / writers ⏱ ~30 min intermediate

When to use: You want a visual map of how notes connect on a topic.

Flow

Cluster

Find notes related to 'distributed systems'. Cluster by sub-topic.✓ Copied

→ Cluster list
Render

Render as a JSON Canvas with grouped boxes and edges for backlinks.✓ Copied

→ .canvas file written

Outcome: A canvas you can open in Obsidian and explore visually.

Pitfalls

Layout overlaps — Skill includes a basic auto-layout; refine in Obsidian

Combinations

Pair with other MCPs for X10 leverage

obsidian-skills-kepano + filesystem

Direct file access for vault edits

Read/write notes via filesystem; obsidian-skills handles conventions.✓ Copied

obsidian-skills-kepano + claude-obsidian-skill

Layer with Daniel's Claude×Obsidian skill

Use both — kepano for conventions, claude-obsidian for daily workflow.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call	Cost
audit_vault	path	Periodic cleanup	tokens scaled to vault size
design_base	folder	Adopting Bases	tokens
render_canvas	note_set, layout?	Visual maps	tokens
obsidian_cli	command	Batch ops via CLI	tokens for parsing output

Cost & Limits

What this costs to run

API quota: N/A
Tokens per call: High on big vaults; scoped to folders helps
Monetary: Free
Tip: Audit per-folder, not whole vault, on first run

Security

Permissions, secrets, blast radius

Minimum scopes: Read/write to vault

Credential storage: None

Data egress: None

Personal notes — be mindful what you paste in chat with cloud agents

Troubleshooting

Common errors and fixes

Bases schema rejected

Property types must match across all notes — skill flags violators

Canvas overlaps

Reduce cluster size or open in Obsidian for manual cleanup

CLI command not found

Install Obsidian CLI separately; the skill assumes it's on PATH

Alternatives