okf-new-kblisted
Install: claude install-skill thattimc/skills
# New OKF knowledge base
Scaffold an empty but complete **Open Knowledge Format (OKF) v0.1** knowledge base. The
result is a self-contained repo that:
- stores knowledge as plain Markdown with YAML frontmatter (one file = one concept),
- is authored by coding agents (Claude Code / Codex) following a bundled `CLAUDE.md`,
- opens directly as an **Obsidian** vault, and
- ships a zero-dependency validator so every change can be checked.
Everything is in this skill's `template/` directory — a clean, lint-passing bundle.
## Steps
1. **Pick the target directory** (should be empty or a fresh git repo). Confirm with the user.
2. **Copy the template in** (note the trailing `/.` so dotfiles like `.gitignore` and
`.obsidian/` come along):
```bash
cp -R "<this skill dir>/template/." "<target dir>/"
```
3. **Personalize**:
- Set the KB name in `README.md` (title) and in `wiki/index.md` (the `# ...` heading).
- Refresh the timestamp in `wiki/overview.md` to now (UTC, `YYYY-MM-DDTHH:MM:SSZ`,
e.g. `date -u +%Y-%m-%dT%H:%M:%SZ`) and set today's date heading in `wiki/log.md`.
4. **Validate**:
```bash
cd "<target dir>" && python3 tools/okf_lint.py
```
Expect `RESULT: PASS`, 0 errors / 0 warnings.
5. **Initialize git** (if not already a repo) and make the first commit:
```bash
git init -q && git add -A && git commit -qm "feat: scaffold OKF knowledge base"
```
6. **Tell the user** they can open the folder as an Obsidian vault ("Open folder as v