okf
okf is a toolkit for building and updating knowledge bundles as directories of markdown files with YAML frontmatter. Create bundles to capture project knowledge like APIs, schemas, and runbooks, maintain them as code and docs evolve, or consume existing bundles to inform your work. The skill enforces the OKF v0.2 spec: every markdown file needs a type field, and everything else follows soft conventions for cross-linking, provenance, and lifecycle tracking.
okf lets you create and maintain portable knowledge bundles as markdown files with YAML frontmatter that both humans and agents can read.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-27
okf lets you create and maintain portable knowledge bundles as markdown files with YAML frontmatter that both humans and agents can read. okf is a toolkit for building and updating knowledge bundles as directories of markdown files with YAML frontmatter. Create bundles to capture project knowledge like APIs, schemas, and runbooks, maintain them as code and docs evolve, or consume existing bundles to inform your work. The skill enforces the OKF v0.2 spec: every markdown file needs a type field, and everything else follows soft conventions for cross-linking, provenance, and lifecycle tracking.
Use it when
- okf bundles use markdown files paired with YAML frontmatter to create portable knowledge.
- okf includes validation tooling to check your bundle against the OKF v0.2 specification.
Verify before relying
Read SKILL.md below before installing (7 files). Open directory: indexed for reading, not audited.
Install
scaccogatto/okf-skills/okf · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I create OKF knowledge bundles?
okf provides a toolkit for building knowledge bundles as directories of markdown files with YAML frontmatter. Start by organizing your project knowledge—APIs, schemas, runbooks, decisions—into a .okf directory. Each markdown file requires a type field in its YAML frontmatter to conform to the OKF v0.2 specification. okf enforces this structure and helps you maintain bundles as your code and documentation evolve.
What is the open knowledge format markdown yaml structure?
okf bundles use markdown files paired with YAML frontmatter to create portable knowledge. The OKF v0.2 spec requires every file to include a type field in its frontmatter; other fields follow soft conventions for cross-linking, provenance, and lifecycle tracking. This markdown + YAML approach lets you treat knowledge as code, versioning and updating it alongside your project.
How do I validate OKF bundle conformance to v0.2 specification?
okf includes validation tooling to check your bundle against the OKF v0.2 specification. The primary requirement is that every markdown file in your .okf directory contains a type field in its YAML frontmatter. okf validates this conformance and helps you identify missing or malformed frontmatter so your bundle stays compliant as you add and update knowledge files.
Can I consume OKF knowledge in agent-driven tasks?
Yes. okf supports a consume mode that lets agents and workflows use existing knowledge bundles as context for their work. Once your bundle is validated and structured, you can feed it into agent-driven tasks to inform decisions, automate documentation, or guide runbook execution. This bridges the gap between static knowledge capture and dynamic task execution.
How do I migrate v0.1 OKF bundles to v0.2?
okf provides migration support for legacy v0.1 bundles. The primary change in v0.2 is the requirement for a type field in every markdown file's YAML frontmatter. okf can help you update your .okf directory structure and frontmatter to meet the current specification, ensuring your older bundles work with the latest tooling.
What are okf's produce, maintain, and consume modes?
okf operates in three modes: produce (create and build new knowledge bundles), maintain (update bundles as code and docs change), and consume (use bundles as context for agent tasks). Together, these modes support the full lifecycle of knowledge as code—from initial capture through ongoing evolution to active use in workflows.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Open Knowledge Format (OKF) skill
OKF represents knowledge as a directory of markdown files with YAML frontmatter. It is minimal by design: no schema registry, no runtime, no SDK. Your job is to produce, maintain, and consume OKF bundles conformant with the spec, not your memory of it.
Always read the canonical spec before non-trivial work: reference/SPEC.md. It is the verbatim OKF v0.2 specification and the source of truth for every rule below.
The
(truncated - see the full file via the links below)
File tree — 7 files
skills/okf/SKILL.md
skills/okf/reference/APACHE-2.0.txt
skills/okf/reference/SPEC.md
skills/okf/scripts/okf_init.py
skills/okf/templates/concept.md
skills/okf/templates/index.md
skills/okf/templates/log.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Create and maintain portable knowledge bundles using markdown + YAML”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
okf-wiki creates a conforming Open Knowledge Format project: a tree of markdown concept files with YAML frontmatter, a validator, and Claude session hooks that orient the agent on the knowledge base. Use it to initialize a wiki, atlas, or institutional memory in a repo, structure docs with provenance metadata, or populate from existing material.
Okf lets you build, organize, and validate Open Knowledge Format (OKF) bundles—plain markdown files with YAML frontmatter stored in a portable directory structure. Initialize new bundles, author concept documents, generate indexes, and render interactive graph viewers. The format is vendor-neutral and lock-in free, consumable by any tool that reads markdown.
Okf Refactor transforms unstructured knowledge from notes, wikis, databases, or catalog exports into conformant OKF v0.1 bundles. It structures content as one-concept-per-file markdown documents with YAML frontmatter, generates navigable indexes, and wires cross-linked knowledge graphs while preserving all source metadata.
OKF is knowledge as code: markdown files with YAML frontmatter organized in directories that both humans and agents can read from the same source. Use this skill to author bundles, migrate existing documentation, search and retrieve knowledge, validate structure, or maintain your project's knowledge graph as it evolves.
wiki-import brings a knowledge graph into your vault from two sources: a graph.json file for page stubs with relationships, or an OKF bundle for complete pages with full bodies. Choose how to handle existing pages—merge, skip, or overwrite—and the skill reconstructs frontmatter, wikilinks, and vault metadata automatically.
Wiki Export transforms your Obsidian vault's wikilink graph into multiple structured formats—JSON, GraphML, Cypher scripts, and interactive HTML—ready for use in Gephi, Neo4j, and custom tools. Optionally filter by project or visibility tags, and assign community IDs for graph analysis and visualization.
More skills Init (unlicensed)