Vault

Name: Vault
Author: joelhooks

joelhooks/joelclaw

28 installs
61 repo stars
Updated August 4, 2026
joelhooks/joelclaw

Operate an Obsidian Vault via the joelclaw CLI to read ADRs and notes, search markdown, and run ADR hygiene and governance checks.

About

Operates Joel's Obsidian Vault through the joelclaw CLI for reading notes, searching, and ADR governance. A developer uses it to read ADRs, search Vault markdown, or audit ADR hygiene.

joelclaw vault CLI for reading ADRs/notes, searching, and listing PARA sections
ADR governance: collisions, audit, locate, refs, rank for decision hygiene

Vault by the numbers

28 all-time installs (skills.sh)
Ranked #1,889 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/joelhooks/joelclaw --skill vault

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/joelhooks/joelclaw/vault.svg)](https://skillselion.com/skills/joelhooks/joelclaw/vault)

Installs	28
repo stars	★ 61
Last updated	August 4, 2026
Repository	joelhooks/joelclaw ↗

What it does

Operate an Obsidian Vault via the joelclaw CLI to read ADRs and notes, search markdown, and run ADR hygiene and governance checks.

Files

SKILL.mdMarkdownGitHub ↗

Vault CLI Operations

Use joelclaw vault as the canonical interface for Vault reads and ADR governance checks.

When to Use

Trigger this skill when the request involves:

Reading ADRs by number/reference
Searching Vault markdown
Listing projects/decisions/inbox/resources
ADR hygiene checks (status drift, collisions, index drift)
Decision inventory/gardening workflows

Command Tree

joelclaw vault
├── read <ref>
├── search <query> [--semantic] [--limit <limit>]
├── ls [section]
├── tree
└── adr
    ├── list [--status <status>] [--limit <limit>]
    ├── collisions
    ├── audit
    ├── locate <query> [--limit <limit>]
    ├── refs <query>
    ├── prompt <text>
    └── rank [--band <band>] [--unscored] [--all]

Core Workflows

1) Read ADRs or notes

joelclaw vault read "ADR-0168"
joelclaw vault read "project 12"
joelclaw vault read "~/Vault/Projects/12-example/index.md"

2) Search vault content

joelclaw vault search "talon watchdog"
joelclaw vault search "content lifecycle" --semantic --limit 5

3) ADR governance checks

joelclaw vault adr list --status proposed --limit 50
joelclaw vault adr collisions
joelclaw vault adr audit
joelclaw vault adr locate "gateway guardrails"
joelclaw vault adr refs 0189-gateway-guardrails
joelclaw vault adr prompt "compare [[0189-gateway-guardrails]] with [[0218-gateway-availability-lifecycle-qol-improvements]]"
joelclaw vault adr rank
joelclaw vault adr rank --band do-now
joelclaw vault adr rank --unscored

vault adr audit is the canonical pre-flight for ADR grooming. It reports:

canonical status counts
missing/non-canonical statuses
duplicate ADR number collisions
broken superseded-by targets
broken or ambiguous wiki links inside ADR bodies
ADR README index drift

vault adr locate resolves ADR files and heading sections by ADR number, slug, title, or heading text.

vault adr refs finds backlinks from ADRs to a resolved ADR file or section.

vault adr prompt expands [[ADR refs]] into canonical ids and appends an <adr-context> block suitable for agents.

vault adr rank is the daily prioritization pass. It enforces NRC scoring and applies a novelty/cool-factor facet (priority-novelty, alias priority-interest) with a neutral default of 3 when missing.

Rules

1. CLI-first only: Do not grep random vault files when joelclaw vault can answer directly. 2. Use audit before ADR surgery: Run joelclaw vault adr audit first, then patch. 3. Canonical statuses only: proposed|accepted|shipped|superseded|deprecated|rejected. 4. Keep index synced: After ADR renames/additions, update ~/Vault/docs/decisions/README.md. 5. Respect collisions as bugs: Any duplicate ADR numeric prefix is a governance bug to resolve.