knowledge

# Claudit: Knowledge Cache Access You are the claudit knowledge provider. When invoked via `/claudit:knowledge [domain ...]`, check the knowledge cache, auto-refresh if stale, and output the requested domain content. This skill is the preferred interface for any tool that needs claudit's cached research. ## Step 1: Parse Arguments Parse `$ARGUMENTS` to determine which domains to retrieve: - `ecosystem` → ecosystem only - `core-config` → core-config only - `optimization` → optimization only - `all`, empty, or missing → all three domains (default) - Multiple space-separated domains → each listed domain (e.g., `ecosystem core-config`) Map each domain to its cache file: | Domain | Cache File | |--------|-----------| | core-config | `~/.cache/claudit/core-config.md` | | ecosystem | `~/.cache/claudit/ecosystem.md` | | optimization | `~/.cache/claudit/optimization.md` | Store the list of requested domains as **REQUESTED_DOMAINS**. ## Step 2: Check Cache Freshness Follow the cache-check protocol (see `${CLAUDE_PLUGIN_ROOT}/references/cache-check-protocol.md`), scoped to REQUESTED_DOMAINS only. 1. Run via Bash: `claude --version 2>/dev/null` → store as **CURRENT_VERSION** 2. Run via Bash: `cat ~/.cache/claudit/manifest.json 2>/dev/null` 3. If the manifest does not exist → all domains are **MISSING**. Go to Step 3. 4. If the manifest exists, apply **three-check invalidation** per requested domain: a. **Version check**: Compare manifest's `claude_code_version` to CURRENT_VERSION. If different → all domains **STALE**. b. **Per-domain time check**: For each domain in REQUESTED_DOMAINS, check `domains.<name>.cached_at`. If age >= `max_ttl_days` (default 7 days) → that domain is **STALE**. c. **File check**: For each domain in REQUESTED_DOMAINS, verify the cache `.md` file exists. If missing → that domain is **STALE**. 5. A domain is **FRESH** only if all three checks pass for it. Partition REQUESTED_DOMAINS into **FRESH_DOMAINS** and **STALE_DOMAINS**. ## Step 3: Refresh Stale Domains If STALE_DOMAINS is empty, skip to Step 4. Tell the user: ``` Refreshing knowledge cache ({list of stale domains})... ``` Run via Bash: `mkdir -p ~/.cache/claudit` Dispatch research agents for stale domains only, in parallel using the Task tool. All must be foreground (do NOT use `run_in_background`). **Research Core** (if `core-config` is stale): - `description`: "Research core config docs" - `subagent_type`: "claudit:research-core" - `prompt`: "Build expert knowledge on Claude Code core configuration. Read the baseline from ${CLAUDE_PLUGIN_ROOT}/skills/claudit/references/known-settings.md first, then fetch official Anthropic documentation for settings, permissions, CLAUDE.md, and memory. Return structured expert knowledge." **Research Ecosystem** (if `ecosystem` is stale): - `description`: "Research ecosystem docs" - `subagent_type`: "claudit:research-ecosystem" - `prompt`: "Build expert knowledge on Claude Code ecosystem features. Fetch official Anthropic documentation for MCP servers, hooks, skills, sub-agents, and plugins. Return structured expert knowledge." **Research Optimization** (if `optimization` is stale): - `description`: "Research optimization docs" - `subagent_type`: "claudit:research-optimization" - `prompt`: "Build expert knowledge on Claude Code performance and over-engineering patterns. Fetch official Anthropic documentation for model configuration, CLI reference, and best practices. Search for context optimization and over-engineering anti-patterns. Return structured expert knowledge." ### Write Cache Persist the refreshed domains and update the manifest by following the **Cache Write Procedure** in `${CLAUDE_PLUGIN_ROOT}/references/cache-check-protocol.md`, passing CURRENT_VERSION and the set of domains you refreshed. ## Step 4: Output Domain Content Read each domain's cache file and output it in this format: ``` === CLAUDIT KNOWLEDGE: {domain} === {content of the cache file} === END CLAUDIT KNOWLEDGE === ``` Repeat for each requested domain. After all domains, output a metadata summary: ``` Knowledge source: {source} | Domains: {list} ``` Where `{source}` is one of: - `cache (fresh, fetched {date})` — if all domains were already fresh - `refreshed ({list of refreshed domains} were stale)` — if any domains needed refresh - `freshly populated (no prior cache)` — if cache was missing entirely --- > Source: [acostanzo/quickstop](https://github.com/acostanzo/quickstop) — distributed by [TomeVault](https://tomevault.io). <!-- tomevault:4.0:skill_md:2026-07-05 -->