okf-wiki

Solid

Scaffold a new Open Knowledge Format (OKF) knowledge base and populate it from existing material: a tree of small markdown concept files with YAML frontmatter, a spec, a validator, and session-start hooks that orient Claude on the knowledge base before it works. Use when the user wants to start an OKF atlas/wiki/knowledge base, build one from existing docs, plans, notes, or a repo, structure docs as one-concept-per-file with provenance, or initialize OKF in a repo (optionally into its GitHub wiki).

Data & Documents 341 stars 58 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
84
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# okf-wiki: scaffold an Open Knowledge Format knowledge base OKF (Open Knowledge Format) stores knowledge as small markdown files: one concept per file, each carrying its own provenance in YAML frontmatter, with directory `index.md` files for navigation and a validator that enforces the contract. It is built for knowledge bases that both people and agents read and edit — newsroom institutional memory, a research atlas, a team's decision log, an infrastructure map. This skill scaffolds a conforming OKF project and validates it. The format contract is in `spec/SPEC.md` (in this skill's directory) — read it before changing structure. ## When to use - The user wants to start an OKF knowledge base, atlas, or wiki. - They want docs structured as one-concept-per-file with provenance, not prose pages. - They want to "initialize OKF" in a repo, optionally publishing into its GitHub wiki. ## Start here: scope the wiki with the user Before you scaffold anything, settle four things with the user. They shape what gets created and how it is published, and they are awkward to retrofit once concepts exist. Ask with `AskUserQuestion` rather than in prose, in two steps: the first three questions in one call, then the publish question as a follow-up call only if the audience came back public or both (it does not apply to an internal-only wiki, and its relevant options depend on that answer, so it cannot share the first batch). Infer the title from the repo or project and confirm it. Skip ...

Details

Author
jamditis
Repository
jamditis/claude-skills-journalism
Created
7 months ago
Last Updated
yesterday
Language
Python
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

okf-new-kb

Scaffold a brand-new personal wiki / knowledge base in the Open Knowledge Format (OKF). Use when the user wants to start a new knowledge base, personal wiki, "second brain", or notes repo from scratch — especially an OKF / agent-managed / Obsidian-friendly one. Triggers: "new knowledge base", "start a wiki", "scaffold an OKF kb", "set up a personal wiki", "create a notes vault", "bootstrap a knowledge base". Stamps a complete, lint-clean OKF bundle plus the agent operating manual, templates, validator, and Obsidian config.

1 Updated today
thattimc
Data & Documents Listed

okf-knowledge-format

Author and validate knowledge as OKF (Open Knowledge Format) bundles — a directory of markdown files with YAML frontmatter, where every concept is one .md file with a REQUIRED `type` field, reserved index.md/log.md files, bundle-relative cross-links, and a permissive conformance model. Use when standing up or maintaining a knowledge bundle/catalog, writing or normalizing a concept document's frontmatter, deciding how to structure markdown knowledge for agents to consume, or checking a corpus against OKF conformance. The canonical spec is vendored under reference/SPEC.md and refreshed from GitHub via scripts/update-spec.sh.

8 Updated 3 days ago
ejklock
AI & Automation Solid

okf

Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read. Use when capturing project knowledge (services, APIs, schemas, metrics, runbooks, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository contains an `.okf/` (or other OKF) bundle that should inform the task. Triggers on: "document this in OKF", "update the knowledge bundle", "capture this as a concept", or any work in a repo that has an OKF bundle.

93 Updated today
scaccogatto