Query this wiki
Agent-neutral workflow. okf-init copies this skill into both .agents/skills/query-wiki/
(where Codex and other agents that scan .agents/skills/ find it) and
.claude/skills/query-wiki/ (where Claude Code finds it) — identical copies of the preset's
canonical skills/query-wiki/. Agents that only read AGENTS.md are pointed here from there.
This vault is an OKF LLM-wiki built by the autowiki autoloop preset.
Knowledge lives in concepts/ (per-tip pages, the core), summaries/ (per-topic), entities/,
comparisons/, the single synthesis.md (the running thesis), and overview.md (start here).
Each sources/clean/<slug>.md is the verbatim extraction a claim traces back to.
Your job: answer the user's question FROM the wiki, with citations — and, when the answer is
worth keeping, file it back as answers/<slug>.md so explorations compound (Karpathy's Query
operation: "good answers can be filed back into the wiki as new pages").
Steps
Search — don't guess which pages are relevant; run the bundled helper (qmd if
installed, else a keyword fallback), from the vault root:
sh .agents/skills/query-wiki/search.sh "<the question>"
It prints the best-matching page paths, most relevant first.
Read the top hits, plus synthesis.md and overview.md for framing, and follow their
relative links into the concepts they cite. For a verbatim quote you may open the relevant
sources/clean/<slug>.md (never sources/raw/).
Answer the user directly, citing the wiki pages you drew on with relative links
([hooks](concepts/hooks.md), [synthesis](synthesis.md)). Quote prose verbatim where you
quote. If the wiki can't answer it, say so plainly and name the gap (a candidate for a
future source) rather than inventing an answer.
Offer to file it back. If the answer is reusable, ask the user (or just do it if they
asked you to save it), writing answers/<slug>.md with <slug> a short kebab-case form of
the question:
- Frontmatter:
type: answer, question: "<the question>", created: <YYYY-MM-DD>,
sources: listing the relative clean-doc paths behind what you cited
(../sources/clean/<slug>.md), tags: a few. NEVER raw http(s):// URLs in sources:.
- Body: the answer + its citations (relative links).
- Add a bullet under
## Answers in index.md:
- [<question>](answers/<slug>.md) — <one-line gist>.
- Prepend a log entry to
log.md (keep its type: log header):
## [<YYYY-MM-DD>] query | <question> with an - answer: and - cited: line.
Rules
- Answer from the wiki; don't fetch external sources here (that's the ingest pipeline's job).
- Relative links, not wikilinks. Every page you create needs a non-empty
type.
- One
answers/ page per question; if it exists, refresh it instead of duplicating.
1---2name: query-wiki3description: Answer a question using this OKF wiki and (optionally) file the answer back as a reusable page. Use when the user asks a question about the wiki's subject matter, asks "what does the wiki say about X", or wants an answer synthesized from the wiki's concepts/synthesis with citations.4---56# Query this wiki78Agent-neutral workflow. `okf-init` copies this skill into both `.agents/skills/query-wiki/`9(where Codex and other agents that scan `.agents/skills/` find it) and10`.claude/skills/query-wiki/` (where Claude Code finds it) — identical copies of the preset's11canonical `skills/query-wiki/`. Agents that only read `AGENTS.md` are pointed here from there.1213This vault is an OKF LLM-wiki built by the `autowiki` autoloop preset.14Knowledge lives in `concepts/` (per-tip pages, the core), `summaries/` (per-topic), `entities/`,15`comparisons/`, the single `synthesis.md` (the running thesis), and `overview.md` (start here).16Each `sources/clean/<slug>.md` is the verbatim extraction a claim traces back to.1718Your job: answer the user's question FROM the wiki, with citations — and, when the answer is19worth keeping, file it back as `answers/<slug>.md` so explorations compound (Karpathy's Query20operation: "good answers can be filed back into the wiki as new pages").2122## Steps231. **Search** — don't guess which pages are relevant; run the bundled helper (qmd if24 installed, else a keyword fallback), from the vault root:2526 sh .agents/skills/query-wiki/search.sh "<the question>"2728 It prints the best-matching page paths, most relevant first.292. **Read** the top hits, plus `synthesis.md` and `overview.md` for framing, and follow their30 relative links into the concepts they cite. For a verbatim quote you may open the relevant31 `sources/clean/<slug>.md` (never `sources/raw/`).323. **Answer** the user directly, citing the wiki pages you drew on with relative links33 (`[hooks](concepts/hooks.md)`, `[synthesis](synthesis.md)`). Quote prose verbatim where you34 quote. If the wiki can't answer it, say so plainly and name the gap (a candidate for a35 future source) rather than inventing an answer.364. **Offer to file it back.** If the answer is reusable, ask the user (or just do it if they37 asked you to save it), writing `answers/<slug>.md` with `<slug>` a short kebab-case form of38 the question:39 - Frontmatter: `type: answer`, `question: "<the question>"`, `created: <YYYY-MM-DD>`,40 `sources:` listing the relative clean-doc paths behind what you cited41 (`../sources/clean/<slug>.md`), `tags:` a few. NEVER raw `http(s)://` URLs in `sources:`.42 - Body: the answer + its citations (relative links).43 - Add a bullet under `## Answers` in `index.md`:44 `- [<question>](answers/<slug>.md) — <one-line gist>`.45 - Prepend a log entry to `log.md` (keep its `type: log` header):46 `## [<YYYY-MM-DD>] query | <question>` with an `- answer:` and `- cited:` line.4748## Rules49- Answer from the wiki; don't fetch external sources here (that's the ingest pipeline's job).50- Relative links, not wikilinks. Every page you create needs a non-empty `type`.51- One `answers/` page per question; if it exists, refresh it instead of duplicating.
mikeyobrien