wiki-context/skill/skill-wiki.md
Travis Herbranson 38f4431341 docs: split skill bundle into separate files + backport live compile/SKILL updates
Separated skill-wiki.md bundle into compile.md, lint.md, migration.md.
Backported compile.md and SKILL.md (skill-wiki.md) from the installed
skill at ~/.claude/skills/wiki-maintenance/ so the repo archive reflects
the shipped two-layer Sources/+Wiki/ taxonomy rather than the old flat draft.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 21:09:54 -04:00

2.5 KiB

name description
wiki-maintenance Use this skill when the user asks to update, compile, lint, or migrate their personal wiki vault. Trigger phrases include "update the wiki", "compile the wiki", "lint the wiki", "migrate the wiki", or any variation referring to maintenance of the LLM Wiki at the configured vault path. The skill maintains a Karpathy-style LLM Wiki with a two-layer structure — Sources (raw project plans and session notes) and Wiki (compiled entity pages, topic landings, synthesis) — under four ownership domains (Dev, Venture, Homelab, Reference). Reads the vault's CLAUDE.md spec at the vault root before performing any operation.

wiki-maintenance

This skill maintains Travis's personal LLM Wiki vault. It does not hold the spec — the spec lives at <vault-root>/CLAUDE.md. This skill holds the procedures.

Vault location

The vault root is the path the user has identified as their HomeLab Obsidian vault. If the path is not stated in the session plan and the user has not provided it in the conversation, ask.

Operations

This skill performs three operations. Each has its own procedure file:

  • Compile — run the wiki compile loop. Procedure: compile.md. Triggers: "update the wiki", "compile the wiki", "run a compile", or similar.

  • Lint — run health checks against the vault. Procedure: lint.md. Triggers: "lint the wiki", "check the wiki", "audit the wiki", or similar.

  • Migrate — one-time migration of an existing vault to the four-folder flat structure. Procedure: migration.md. Triggers: "migrate the wiki", "reorganize the vault", "set up the wiki structure", or similar.

Pre-flight (every operation)

Before any operation, read these files in order:

  1. <vault-root>/CLAUDE.md — the vault spec
  2. <vault-root>/log.md — the event log; identifies the last compile/lint/migration timestamp
  3. The relevant procedure file from this skill

If any required file is missing, stop and report. Do not proceed on assumptions.

Operating principles

  • Every operation is one-shot. No autonomous follow-up.
  • Stop at confirmation gates specified in the procedure files. Wait for explicit user confirmation.
  • Never modify files outside the vault.
  • Never run autonomously across multiple operations in one invocation. If the user wants compile-then-lint, treat them as two requests.
  • All git operations follow the protocol in CLAUDE.md — pre-commit, post-commit, with reasoning in the body.
  • Report concisely. Skip celebratory framing. State what was done, what's next, what's blocked.