okf
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.
OKF lets you capture project knowledge as portable markdown bundles with YAML frontmatter for humans and agents to read together.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-25
OKF lets you capture project knowledge as portable markdown bundles with YAML frontmatter for humans and agents to read together. 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.
Use it when
- Open Knowledge Format (OKF) is a specification for knowledge as code: markdown files with YAML frontmatter organized in a portable.
- OKF supports migration of existing documentation through structured conversion: extract content from your current docs.
Verify before relying
Read SKILL.md below before installing (18 files). Open directory: indexed for reading, not audited.
Install
serradura/okf-gem/okf · repository language: Ruby
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 organize project knowledge as markdown files with OKF?
OKF organizes project knowledge as portable markdown bundles with YAML frontmatter. Each markdown file represents a concept or topic, prefaced with YAML metadata (title, tags, relationships). Files are grouped in directories by domain or function. This structure lets both humans and agents read from the same source, making knowledge searchable, versionable, and maintainable as code alongside your project.
What is the Open Knowledge Format and how do I set up a bundle?
Open Knowledge Format (OKF) is a specification for knowledge as code: markdown files with YAML frontmatter organized in a portable directory structure. To set up an OKF bundle, create a root directory, add markdown files with YAML headers (title, tags, links), and organize them by topic or service. OKF bundles are self-contained, version-controllable, and designed for both human reading and agent consumption.
How can I convert existing documentation into OKF structure?
OKF supports migration of existing documentation through structured conversion: extract content from your current docs, create markdown files for each concept or page, add YAML frontmatter with metadata (title, tags, relationships to other concepts), and organize files into a directory hierarchy. OKF's linting and validation tools help ensure conformance during migration, catching structural issues before your bundle goes live.
How do I search and retrieve knowledge from an OKF bundle?
OKF bundles enable fast retrieval without reading entire documentation. Search by concept name, tag, or semantic relationship through the YAML metadata. The bundle structure and frontmatter make it easy to locate specific knowledge, traverse related concepts via markdown links, and consume bundle content as context for agents or tools without loading everything at once.
How does OKF validate and lint bundle quality and conformance?
OKF provides validation and linting tools to curate bundle structure and enforce conformance rules. These tools check YAML frontmatter integrity, verify markdown syntax, validate link references, and detect structural issues. Regular validation ensures your knowledge bundle stays well-formed, searchable, and maintainable as it evolves, catching problems early before they degrade retrieval or agent consumption.
Can OKF model knowledge as emergent graphs through markdown links?
Yes. OKF models knowledge as emergent graphs by leveraging markdown links and semantic relationships defined in YAML frontmatter. As you link concepts together and tag them consistently, the bundle naturally forms a graph structure. This allows visualization of how ideas connect, discovery of related knowledge, and understanding of your project's conceptual landscape without manual graph construction.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Open Knowledge Format (OKF)
You are the OKF expert in this repository. OKF is knowledge as code: a directory of markdown files,
(truncated - see the full file via the links below)
File tree — 15 files
plugin/skills/okf/SKILL.md
plugin/skills/okf/playbooks/consume.md
plugin/skills/okf/playbooks/curate.md
plugin/skills/okf/playbooks/doctor.md
plugin/skills/okf/playbooks/maintain.md
plugin/skills/okf/playbooks/menu.md
plugin/skills/okf/playbooks/migrate.md
plugin/skills/okf/playbooks/produce.md
plugin/skills/okf/playbooks/refine.md
plugin/skills/okf/playbooks/search.md
plugin/skills/okf/reference/APACHE-2.0.txt
plugin/skills/okf/reference/SPEC.md
plugin/skills/okf/reference/authoring.md
plugin/skills/okf/reference/cli.md
plugin/skills/okf/templates/concept.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, organize, and maintain project knowledge as portable markdown bundles with YAML frontmatter”
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 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 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.
Init scaffolds a self-contained knowledge base directory in plain markdown that enables persistent memory across coding sessions. It sets up OKF v0.1-compliant note storage, memory protocols for agent read/write rules, a capture inbox, and vendored CLI tooling—all without requiring a database or external server.
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.
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 wiki-import (MIT) · Okf (unlicensed)