vault-status

Scan local vaults and report page counts, sources, activity, and git cleanliness.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RonanCodes/llm-wiki --skill vault-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-status
Source: https://github.com/RonanCodes/llm-wiki/tree/main/.claude/skills/vault-status
Command: npx skills add https://github.com/RonanCodes/llm-wiki --skill vault-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a single, machine-readable overview of all LLM Wiki vaults so users don't have to manually inspect directories and run git or shell commands across multiple vaults to understand page counts, sources, recent activity, and repository cleanliness.

Core Features & Use Cases

  • Automatic vault discovery: Scans the vaults/ directory and treats subdirectories containing a CLAUDE.md file as vaults.
  • Per-vault metrics: Computes page counts (wiki/.md excluding index.md), source counts (raw/ files), extracts domain from CLAUDE.md, reads last activity from log.md, and reports git cleanliness via git status.
  • Readable output and guidance: Presents results as a markdown table and suggests creating a vault when none are found. Useful for repository maintainers who want regular health checks, CI status reports, or quick audits before sharing a vault.

Quick Start

Run the /vault-status command to list all vaults with pages, sources, last activity, and git cleanliness.

Frequently Asked Questions about vault-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the health and git status of all my local LLM Wiki vaults at once?

To check vault health, you can scan the vaults/ directory for subdirectories containing CLAUDE.md, then parse wiki/, raw/, and log.md files to compute page counts, source counts, last activity, and git cleanliness into a markdown table.

What is the best way to generate a markdown table report of page counts and source files across multiple wiki vaults?

Generating a markdown table report of wiki vaults involves running shell utilities like find, grep, and wc to count .md files in wiki/ and files in raw/, extracting domains from CLAUDE.md, and formatting the aggregated metrics.

How do I run a quick audit to see recent activity and repository cleanliness for local wiki vaults?

Running a quick audit of local wiki vaults requires reading the last activity timestamp from log.md and executing git status in each vault directory to report repository cleanliness alongside computed page and source counts.

Does the vault status check require any external dependencies or components to run?

No external dependencies or components are required to run the vault status check; it relies entirely on built-in shell utilities like find, grep, wc, and git to parse local directories and compute vault metrics.

What happens if no valid LLM Wiki vaults are found during the directory scan?

If no valid LLM Wiki vaults are found during the directory scan, the process suggests creating a new vault, ensuring users receive guidance rather than an empty markdown table when subdirectories lack a CLAUDE.md file.

How does the vault health check identify which subdirectories to treat as active vaults?

The vault health check identifies active vaults by scanning the vaults/ directory and treating only subdirectories that contain a CLAUDE.md file as valid vaults, parsing their wiki/, raw/, and log.md files for metrics.