Agent skill · software engineering · mvanhorn
pp-obsidian
Read-only Obsidian vault analytics CLI. Wraps the official `obsidian` binary (v1.12+) for live reads and maintains a local SQLite mirror for offline compound analytics (health score, orphans with age ranking, stale notes, broken wikilinks with source context, raw SQL). V1 is read-only by design — writes wait on the upstream markdown-patch frontmatter-corruption fix.
Why this skill is useful
Adds specific commands for read-only analytics on Obsidian vaults that the AI wouldn't reliably generate on its own.
What it needs
Requires obsidian-pp-cli installed locally. About 5k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
Obsidian — Printing Press CLI Prerequisites: Install the CLI This skill drives the obsidian-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: 2. Verify: obsidian-pp-cli --version 3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill. If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer): If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds. When Not to Use This CLI Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis. HTTP Transport This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls. Command Reference deadends — Manage deadends obsidian-pp-cli deadends — List notes with no outgoing links files — Manage files obsidian-pp-cli files — Wraps obsidian files. Filter by folder or extension. folders — Manage folders obsidian-pp-cli folders — Wraps obsidian folders. live-search — Manage live search obsidian-pp-cli live-search context — Wraps obsidian search:context query=<text> — body-text search with surrounding lines for each hit. obsidian-pp-cli live-search live-search — Wraps obsidian search query=<text> — dials the running Obsidian process for body-text search. Distinct from the... …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/pp-obsidian--67d7b9