okf-skills
starsforks
How to install okf-skills?
scaccogatto/okf-skills
$git clone https://github.com/scaccogatto/okf-skillsThe OKF toolkit for Claude Code — author, maintain, validate & visualize Open Knowledge Format bundles. Claude Code plugin + skills.sh.
README.md
| 1 | <div align="center"> |
| 2 | |
| 3 | # 📚 okf — the Open Knowledge Format toolkit for Claude Code |
| 4 | |
| 5 | **Teach your coding agent to author, maintain, validate, and *visualize* portable |
| 6 | knowledge bundles — markdown your team and your agents both read.** |
| 7 | |
| 8 | [](LICENSE) |
| 9 | [](skills/okf/reference/SPEC.md) |
| 10 | [](https://code.claude.com/docs/en/plugins) |
| 11 | [](https://skills.sh/scaccogatto/okf-skills) |
| 12 | [](#contributing) |
| 13 | |
| 14 | ### ▶ [**Open the live demo**](https://scaccogatto.github.io/okf-skills/) — a real OKF bundle as an interactive graph |
| 15 | |
| 16 | [](https://scaccogatto.github.io/okf-skills/) |
| 17 | |
| 18 | *Click any node → rendered markdown, typed metadata, and "Links to / Cited by" backlinks. No backend, nothing leaves the page.* |
| 19 | |
| 20 | ```shell |
| 21 | /plugin install okf@scaccogatto |
| 22 | npx skills add scaccogatto/okf-skills |
| 23 | ``` |
| 24 | |
| 25 | </div> |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | > [**OKF**](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing) |
| 30 | > is an open, vendor-neutral format (announced by Google Cloud, June 2026) that |
| 31 | > represents knowledge — the context and curated insight around your systems — as |
| 32 | > a directory of markdown files with YAML frontmatter. No schema registry. No |
| 33 | > runtime. No SDK. If you can `cat` a file you can read it; if you can `git clone` |
| 34 | > a repo you can ship it. |
| 35 | |
| 36 | This is the **Claude Code-native** OKF toolchain. It teaches Claude to **produce**, |
| 37 | **maintain**, **consume**, **validate**, and **visualize** OKF bundles as a normal |
| 38 | part of how it already works — driven by the *verbatim* spec, backed by a |
| 39 | deterministic conformance checker, with a self-contained graph renderer. Ships as |
| 40 | a **Claude Code plugin** and as **agent skills** (Cursor, Codex, and 20+ agents). |
| 41 | |
| 42 | ## Why knowledge-as-code (and where OKF fits) |
| 43 | |
| 44 | Project knowledge lives scattered across wikis, code comments, and people's heads; |
| 45 | agents re-discover it from scratch every session. OKF gives it one durable, |
| 46 | diffable, portable home — versioned next to the code it describes. It is |
| 47 | **complementary** to the rest of your context stack, not a replacement: |
| 48 | |
| 49 | | | **OKF bundle** (this) | `CLAUDE.md` | Claude auto-memory | Wiki / Notion | |
| 50 | |---|:---:|:---:|:---:|:---:| |
| 51 | | Purpose | curated **knowledge** | standing **instructions** | implicit notes | human docs | |
| 52 | | Portable across agents/tools | ✅ plain md + yaml | ⚠️ Claude-specific | ❌ per-agent store | ⚠️ export needed | |
| 53 | | Versioned with code in git | ✅ | ✅ | ❌ | ❌ | |
| 54 | | Typed & queryable | ✅ frontmatter | ❌ prose | ❌ | ⚠️ | |
| 55 | | Graph of linked concepts | ✅ | ❌ | ❌ | ⚠️ | |
| 56 | | Curated & reviewed in PRs | ✅ | ✅ | ❌ implicit | ⚠️ | |
| 57 | | Scales past the context window | ✅ progressive disclosure | ❌ loaded wholesale | ⚠️ | n/a | |
| 58 | |
| 59 | Use `CLAUDE.md` for *how to behave*, auto-memory for *what the agent picked up*, |
| 60 | and an OKF bundle for *what the team knows* — shared, structured, and shippable. |
| 61 | |
| 62 | > 🪞 **This repo documents itself in OKF.** The architecture, skills, and decisions |
| 63 | > behind okf-skills live in [`.okf/`](.okf/) — explore them as a |
| 64 | > [**live self-graph**](https://scaccogatto.github.io/okf-skills/self.html). CI |
| 65 | > validates that bundle on every push (dogfooding the conformance checker). |
| 66 | |
| 67 | ## What's inside |
| 68 | |
| 69 | | Component | What it does | |
| 70 | |-----------|--------------| |
| 71 | | `/okf:okf` skill | Produce / maintain / consume bundles, applying the spec and templates. Auto-triggers when a repo has an OKF bundle. | |
| 72 | | `/okf:validate` skill | Deterministic §9 conformance check (not an eyeball pass). | |
| 73 | | `/okf:visualize` skill | Render a bundle to a self-contained interactive HTML graph (`viz.html`). | |
| 74 | | `skills/okf/scripts/okf_init.py` | Scaffold a conformant starter bundle (`index.md`, `log.md`, a starter concept) in one shot. | |
| 75 | | `skills/validate/scripts/okf_validate.py` | Standalone, zero-config validator (`uv run`, PyYAML via PEP 723). | |
| 76 | | `skills/visualize/scripts/okf_visualize.py` | Standalone bundle→`viz.html` renderer (Cytoscape + marked via CDN). | |
| 77 | | `skills/okf/reference/SPEC.md` | The OKF v0.1 spec, vendored verbatim — the source of truth. | |
| 78 | | `templates/CLAUDE-okf.md` | Snippet that turns on automatic consume/maintain in your project. | |
| 79 | | `examples/sample-bundle/` | The conformant bundle behind the [live demo](https://scaccogatto.github.io/okf-skills/) — code, data, decisions, runbooks, metrics. | |
| 80 | |
| 81 | ## Install |
| 82 | |
| 83 | **As a Claude Code plugin** (one-plugin marketplace): |
| 84 | |
| 85 | ```shell |
| 86 | /plugin marketplace add scaccogatto/okf-skills |
| 87 | /plugin install okf@scaccogatto |
| 88 | ``` |
| 89 | |
| 90 | **As agent skills via [skills.sh](https://skills.sh/scaccogatto/okf-skills)** (Claude Code, Cursor, Codex, and 20+ agents): |
| 91 | |
| 92 | ```shell |
| 93 | npx skills add scaccogatto/okf-skills # inst |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
