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>.
Installs
3
GitHub Stars
5
First Seen
Jun 14, 2026
okf-refactor — duyet/codex-claude-plugins