okf plugin
Author, maintain, backfill, validate, visualize and serve (MCP) Open Knowledge Format (OKF) bundles.
How to install the okf plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add scaccogatto/okf-skills
/plugin install okf@scaccogattoWhat's inside okf
8 parts read from the plugin's own files.
Agents 2
Call as @agent-okf:name- @agent-okf:bundle-weaversonnet
>-
- @agent-okf:event-analyzerhaiku
>-
Skills 4
Claude loads it when the task matches- backfill
Reconstruct an OKF bundle by event-sourcing a repository's history (git log and Claude session transcripts). Use when creating an `.okf/` bundle for an existing repository that predates this skill, or when resuming an interrupted backfill session. Triggers on: "reconstruct the OKF bundle", "backfill the knowledge bundle", "event-source the history".
- okf
Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read. Use when capturing project knowledge (services, APIs, schemas, metrics, runbooks, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository contains an `.okf/` (or other OKF) bundle that should inform the task. Triggers on: "document this in OKF", "update the knowledge bundle", "capture this as a concept", or any work in a repo that has an OKF bundle.
- validate
Validates OKF bundles against the v0.2 specification and migrates legacy v0.1 bundles to the current version.
- visualize
Render an Open Knowledge Format (OKF) bundle as a single self-contained, interactive HTML graph (viz.html) — concepts as nodes coloured by type and sized by body length, markdown links and bundle-internal `sources` as edges, a wiki-style detail panel with rendered markdown, v0.2 trust/lifecycle/provenance metadata, and "Links to" / "Cited by" backlinks, layout switching, per-type filter and search. Use when asked to visualize, graph, preview, or explore an OKF bundle.
Hooks 1
Runs on these events- Stopcommand
No description in the file.
MCP servers 1
Starts with the plugin- bundlestdio
uv run ${CLAUDE_PLUGIN_ROOT}/servers/okf_mcp.py
Using okf in Claude Code
Ask for an agent by name:
@agent-okf:bundle-weaver
@agent-okf:event-analyzerSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update okf@scaccogatto
- Refresh the marketplace
- /plugin marketplace update scaccogatto
- Turn it off for now
- /plugin disable okf@scaccogatto
- Remove it
- /plugin uninstall okf@scaccogatto
Skills in okf
- backfillscaccogatto/okf-skills
Reconstruct an OKF bundle by event-sourcing a repository's history (git log and Claude session transcripts). Use when creating an `.okf/` bundle for an existing repository that predates this skill, or when resuming an interrupted backfill session. Triggers on: "reconstruct the OKF bundle", "backfill the knowledge bundle", "event-source the history".
2 files452stars - okfscaccogatto/okf-skills
Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read. Use when capturing project knowledge (services, APIs, schemas, metrics, runbooks, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository contains an `.okf/` (or other OKF) bundle that should inform the task. Triggers on: "document this in OKF", "update the knowledge bundle", "capture this as a concept", or any work in a repo that has an OKF bundle.
5 files452stars - validatescaccogatto/okf-skills
Validates OKF bundles against the v0.2 specification and migrates legacy v0.1 bundles to the current version.
2 files452stars - visualizescaccogatto/okf-skills
Render an Open Knowledge Format (OKF) bundle as a single self-contained, interactive HTML graph (viz.html) — concepts as nodes coloured by type and sized by body length, markdown links and bundle-internal `sources` as edges, a wiki-style detail panel with rendered markdown, v0.2 trust/lifecycle/provenance metadata, and "Links to" / "Cited by" backlinks, layout switching, per-type filter and search. Use when asked to visualize, graph, preview, or explore an OKF bundle.
2 files452stars
okf plugin questions
How do I install the okf plugin?
In Claude Code run /plugin marketplace add scaccogatto/okf-skills, then /plugin install okf@scaccogatto.
What does the okf plugin include?
okf bundles 2 agents, 4 skills, hooks, MCP servers.
Which agents come with okf?
bundle-weaver, event-analyzer. Call one with @agent-okf:bundle-weaver.
How do I update or remove the okf plugin?
Update it with claude plugin update okf@scaccogatto in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall okf@scaccogatto.
What license is the okf plugin under?
MIT, as stated in the plugin's manifest.