---
name: crate-vault
description: >-
  Operate a CRATE knowledge vault: raw/, wiki/, meta/, compile, ask, lint,
  wiki-graph, reports, and safe wiki-check apply. Use when editing or
  automating a CRATE vault, running crate CLI, or interpreting meta/*.json.
---

# CRATE vault agent skill

## What CRATE is

CRATE is a **local-first** toolchain: **`raw/`** holds sources; **`wiki/`** holds compiled Markdown; **`meta/`** holds fingerprints, embeddings DB, and JSON indexes. The CLI is `crate` (see repo `docs/usage.md`).

## Read first

- **`AGENTS.md`** at vault root (if present): project-specific rules.
- **`docs/usage.md`** in the crate repo: full command reference.
- **`docs/providers.md`**: multi-vendor LLM + embedding (`CRATE_LLM_PROVIDER`, OpenAI-compatible APIs).
- **`meta/wiki_index.json`**: multi-page wiki graph from `crate compile --wiki-graph`.
- **`meta/wiki_body_graph.json`**: prose link graph from `crate wiki graph`.
- **`meta/raw_wiki_coverage.json`**: optional; from `crate report raw-wiki --write`.

## Safe defaults

- Do **not** bulk-overwrite user wiki pages unless the user asked.
- **`crate wiki-check --apply`** only merges **whitelist** fields on concept pages (`related_slugs` / `conflicts_with_slugs` per server implementation); never treat model output as permission to erase bodies.
- Prefer **`crate wiki promote`** to move a vetted answer from **`wiki/outputs/`** into **`wiki/concepts/`**.

## Command map

| Goal | Command |
|------|---------|
| Compile raw → wiki note or multi-page wiki | `crate compile` / `crate compile --wiki-graph` |
| Watch `raw/` | `crate watch` (optional `--native` with watchdog) |
| Q&A | `crate ask` / `crate ask-multi` |
| Deterministic link checks | `crate lint` (add `--wikilinks`, `--orphans`, `--strict-concepts` as needed) |
| Prose link graph JSON | `crate wiki graph` (`--md` for `wiki/_index/BODYGRAPH.md`) |
| Raw coverage report | `crate report raw-wiki` (`--write` for JSON under `meta/`) |
| Session-scoped compile | List paths in `.crate/ingest_session.md` then `crate ingest` |
| Extended notes index | `crate wiki index-extend` → `meta/wiki_index_extended.json` |
| Semantic wiki audit | `crate wiki-check` (optional `--apply-dry-run` / `--apply`) |
| HTTP URL check (opt-in) | `crate lint --http-external` (set `SKIP_HTTP_LINT=1` to skip) |
| Diagnostics | `crate doctor` |

## Install locations (any agent host)

See **`docs/agent-skill.md`** in the crate repository for Cursor, Claude Code, OpenClaw, and generic “paste this file into instructions” workflows.