okf-refactor
Installation
SKILL.md
okf-refactor — convert existing knowledge into an OKF bundle
Goal
Take knowledge that already exists in some other shape — a folder of loose
markdown notes, a wiki, README/docs, a data-catalog export, a database schema, a
JSON/CSV metadata dump — and emit a conformant OKF v0.1 bundle: a directory of
one-concept-per-file markdown docs with YAML frontmatter, navigable index.md
files, and a cross-linked knowledge graph.
This skill depends on the okf skill for the format itself. Read
../okf/reference/SPEC.md (the bundled OKF v0.1 spec) before refactoring — it is
the source of truth. Use ../okf/scripts/validate_okf.py to check the result.
Inputs and outputs
- Input (
<src>): a directory, file set, or export to read FROM. Treat it as immutable ground truth — never edit the source in place. - Output (
<out>): the bundle directory to write TO. New, separate from<src>.