About

Imported from joelhooks/joelclaw (skills/vault/SKILL.md). Install upstream with npx skills add joelhooks/joelclaw --skill vault. Copyright stays with the author.

Vault CLI Operations

Name: vault
Author: joelhooks

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

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

References

ADR-0081: Vault CLI & Agent Tool Access
ADR-0173: ADR Number Collision Remediation
ADR-0174: Vault Command Tree + ADR Audit CLI
CLI docs: ~/Code/joelhooks/joelclaw/docs/cli.md

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/joelhooks-joelclaw-vault/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

joelhooks-joelclaw-vault.ocm.jsonjson

{
  "ocm": "1",
  "id": "joelhooks-joelclaw-vault",
  "kind": "skill",
  "name": "vault",
  "description": "Operate Joel's Obsidian Vault through the joelclaw CLI. Use when reading ADRs/projects, searching notes, listing PARA sections, or auditing ADR hygiene with `vault adr` commands. Triggers on: 'check the vault', 'read ADR', 'find this note', 'vault search', 'ADR collisions', 'ADR audit', 'decision inventory', or any Vault command task.",
  "publisher": "joelhooks",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "joelclaw",
      "vault",
      "adr",
      "cli",
      "para",
      "governance",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Operate Joel's Obsidian Vault through the joelclaw CLI. Use when reading ADRs/projects, searching notes, listing PARA sections, or auditing ADR hygiene with `vault adr` commands. Triggers on: 'check the vault', 'read ADR', 'find this note', 'vault search', 'ADR collisions', 'ADR audit', 'decision inventory', or any Vault command task."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/joelhooks/joelclaw",
      "path": "skills/vault/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/joelhooks/joelclaw/blob/HEAD/skills/vault/SKILL.md",
      "key": "joelhooks/joelclaw/skills/vault/SKILL.md"
    }
  },
  "instructions": "# Vault CLI Operations\n\nUse `joelclaw vault` as the canonical interface for Vault reads and ADR governance checks.\n\n## When to Use\n\nTrigger this skill when the request involves:\n\n- Reading ADRs by number/reference\n- Searching Vault markdown\n- Listing projects/decisions/inbox/resources\n- ADR hygiene checks (status drift, collisions, index drift)\n- Decision inventory/gardening workflows\n\n## Command Tree\n\n```bash\njoelclaw vault\n├── read <ref>\n├── search <query> [--semantic] [--limit <limit>]\n├── ls [section]\n├── tree\n└── adr\n    ├── list [--status <status>] [--limit <limit>]\n    ├── collisions\n  ",
  "cost": {
    "context_tokens": 755
  }
}

Fetch it by URL: GET /api/v1/registry/joelhooks-joelclaw-vault/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.