38f4431341
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>
61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
---
|
|
name: wiki-maintenance
|
|
description: 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.
|