lorsabyan/okf-skill

okf-skill is an Agent Skill, a small package of instructions and tools that teaches coding assistants like Claude Code and OpenAI Codex how to work with a format called Open Knowledge Format, or OKF. OKF bundles are directories of markdown files with YAML frontmatter that describe things like datasets, tables, metrics, APIs, and playbooks. Instead of writing that documentation by hand, this skill gives an AI agent the knowledge it needs to author, validate, and read these bundles correctly. The repository is organized around a single skill folder. Inside it, a file called SKILL.md holds a quick reference to the OKF format along with workflows for authoring, validating, and consuming bundles. A references folder contains the full OKF v0.1 specification, copied from Google's knowledge-catalog project. A scripts folder holds a validator written in plain Python with no external dependencies, which checks whether a given bundle follows the format correctly. Installing the skill is a matter of copying or symlinking the okf folder into the right place. For Claude Code, that means placing it in a personal skills directory that applies across all projects, or in a project-specific skills folder. Once it is there, Claude Code recognizes tasks related to OKF or knowledge bundles automatically, or a user can call it directly with a slash command. Codex CLI uses the same file format, so the folder can be copied into its skills directory in the same way. The included validator script can be run from the command line against any bundle directory. It checks required structural rules, such as parseable frontmatter and non-empty type fields, as hard errors, and flags softer issues like broken cross-links or missing descriptions as warnings. A strict mode turns those warnings into errors as well. The author reports that the validator passes cleanly against the three reference bundles shipped with the original OKF specification project. The repository also points to a companion project called okf-reader, a separate web app for browsing OKF bundles. The skill itself is released under the Apache 2.0 license, though the reproduced specification document keeps its original Google copyright.