okf-wiki

Featured

Builds an Open Knowledge Format (OKF) knowledge base from existing docs, notes, or a repo. Use to scaffold an OKF wiki.

Data & Documents 391 stars 65 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 92/100

Stars 20%
86
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 an...

Details

Author
jamditis
Repository
jamditis/claude-skills-journalism
Created
8 months ago
Last Updated
4 days ago
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 1 months ago
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.

13 Updated 3 days ago
ejklock
AI & Automation Solid

okf

Create, read, and maintain Open Knowledge Format documentation bundles in repositories. Use this skill when the user asks for /okf, OKF, Open Knowledge Format, docs-as-knowledge, reading project context from docs, reorganizing docs into an agent-readable bundle, updating docs/specs/ADRs after a session or PR, or adding AGENTS.md instructions for agents to consume and maintain the docs bundle. Supports /okf read, /okf init, and /okf update workflows.

63 Updated 3 days ago
gannonh