okf-ingestlisted
Install: claude install-skill thattimc/skills
# Ingest into an OKF knowledge base
Add a source or concept to an OKF wiki as one Markdown file (a "concept"). If the repo has a
`CLAUDE.md`, **that is authoritative — follow it** (this skill summarizes the same rules so it
works standalone).
## 0. Orient
- The bundle is the `wiki/` directory. Edit knowledge only there. A concept's id is its path
minus `.md` (`wiki/papers/foo.md` → `papers/foo`).
- If `tools/okf_lint.py` exists, you'll run it at the end.
## 1. Verify — never fabricate
Fetch the real source and confirm its facts from the source itself, not memory (your training
cutoff may predate it):
- **arXiv**: `curl -sL "http://export.arxiv.org/api/query?id_list=<id>"` — read the canonical
`<title>`, `<author>` list, and `<published>` date. If the id is unknown, search:
`...query?search_query=ti:%22<title words>%22&max_results=5`.
- **Web**: use WebFetch on the URL; capture title, author/site, date.
- If you cannot confirm it exists, **stop and tell the user** — do not invent metadata.
- Optionally save the raw capture under `raw/` (read-only provenance, outside the bundle).
## 2. Place it
- Choose a **domain folder** by subject (`wiki/papers/`, `wiki/people/`, …) — folder = subject,
`type` = kind. Create the folder + an `index.md` if it's new.
- Choose a lowercase, hyphenated **slug** (matches `[A-Za-z0-9_][A-Za-z0-9_.-]*`, no spaces).
## 3. Write `wiki/<domain>/<slug>.md`
Frontmatter (keys in this order; use `templates/<type>.md` as a stamp if present):