okf

okf is a skill for Claude Code, Codex from scaccogatto/okf-skills. It costs 127 tokens per session (2,181 once invoked), scanned A, original, MIT.

A guide for creating and maintaining Open Knowledge Format bundles: folders of Markdown files with YAML metadata that store project knowledge such as services, APIs, schemas, metrics, and decisions.

In plain words
What is it for?
Use it to capture, update, and consume documented project facts, technical decisions, and operational information.
Why use it?
It gives project knowledge a portable structure that both people and software agents can read and update.

Skill for Claude CodeCodex

Written for Claude Code and Codex: allowed-tools in frontmatter, but also agents/openai.yaml present.

Part of the okf plugin — 4 skills, 2 agents, 1 hook, 1 MCP server shipped together

Good fit Use it to capture, update, and consume documented project facts, technical decisions, and operational information.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/scaccogatto/okf-skills/okf
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add scaccogatto/okf-skills --skill okf
Clone the repo
git clone --depth 1 https://github.com/scaccogatto/okf-skills

Made for: Claude Code, Codex.

Or install okf, the plugin that ships this one along with the rest of its 4 skills, 2 agents, 1 hook, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for okf

README.md
[![agentmods](https://agentmods.dev/badge/skills/scaccogatto/okf-skills/okf/github.svg)](https://agentmods.dev/skills/scaccogatto/okf-skills/okf)
Your own site
<a href="https://agentmods.dev/skills/scaccogatto/okf-skills/okf"><img src="https://agentmods.dev/badge/skills/scaccogatto/okf-skills/okf/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for okf

Your own site · 80×15
<a href="https://agentmods.dev/skills/scaccogatto/okf-skills/okf"><img src="https://agentmods.dev/badge/skills/scaccogatto/okf-skills/okf.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 127 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,181 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 22 Oct 2026
  • Snyk pass 22 Oct 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00127 $0.02181
Opus 5.5 $0.00051 $0.00872
Sonnet 5.5 $0.00025 $0.00436
Haiku 4.5 $0.00013 $0.00218

Measured 4d ago against content hash 34ed98afdccd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

okf scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/okf_init.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/okf/SKILL.md · 161 lines

How it starts

The opening of the file, as written. The whole thing — 161 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Open Knowledge Format (OKF) skill

OKF represents knowledge as a directory of markdown files with YAML frontmatter. It is minimal by design: no schema registry, no runtime, no SDK. Your job is to produce, maintain, and consume OKF bundles conformant with the spec, not your memory of it.

Always read the canonical spec before non-trivial work: reference/SPEC.md. It is the verbatim OKF v0.2 specification and the source of truth for every rule below.

The one hard rule

A bundle is conformant (§11) iff: every non-reserved .md file has a parseable YAML frontmatter block, and every such block has a non-empty type field. Everything else is soft guidance. Consumers MUST tolerate missing optional fields, unknown types, and broken links — never reject a bundle over them.

Conventions to apply

  • One concept = one file. The file path (minus .md) is the concept ID.
  • Frontmatter: type is required. Add title, description, tags when they aid consumption; add resource (a canonical URI) only for concepts bound to a real asset — omit it for abstract concepts.
  • Body: prefer structural markdown (headings, tables, lists, fenced code). Conventional headings: # Schema, # Examples, # Computation.
  • Cross-links: standard markdown links; prefer absolute bundle-relative form (/services/auth-api.md). A link asserts a relationship; its kind lives in the surrounding prose, not the link.
  • Reserved files: index.md (directory listing, no frontmatter, except the bundle-root index, which may carry okf_version and this plugin's upkeep: enforced opt-in flag, plus recursive: true (or a depth n: levels below the root, true is 6) to make the hook watch nested git repos) and log.md (ISO-dated history, newest first). Never use these names for concepts.
  • What goes in log.md: lifecycle events only, written in the bundle-root log.md: a bundle created, a concept deprecated or retired, one concept superseding another, concepts regenerated after their source changed, a verification pass. Routine edits to a concept do not get an entry: its generated and git already record them. A log is append-only, so never rewrite or drop an existing entry.

Read the full file on GitHub · 161 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago Changed · +1 lines 34ed98afdccd
  2. 27d ago Changed · +7 lines ad4a2d130643
  3. 1mo ago Changed · +1 lines 2bb0823455f6
  4. 1mo ago Changed · +4 lines 89bd969c90f2
  5. 1mo ago First seen · 148 lines · 127 tokens per session scan A f3bf590ef2d8

Subscribe to this mod's changes

okf is a skill published in the GitHub repository scaccogatto/okf-skills (426 stars, last pushed 4d ago), licensed MIT. It adds 127 tokens to every session and 2,181 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

deck-ai

Generate modern presentation decks (PDF) from markdown content. Local open-source alternative to Gamma — uses Slidev for layouts and Unsplash for imagery. Invoke when the user asks to "make a deck", "build slides from this", or "turn this into a presentation".

assafkip/kipi-system · 57 tokens

okf-pro

Operating rules for the .okf/ knowledge bundle — filing new concepts, the board, the journal, the daily snapshot, closing work, source attribution, and the generated/verified attestation policy. Use before reading from or writing anything into .okf/.

serradura/okf · 56 tokens

core

This skill should be used when the user says "capture memory", "save to memory", "remember this", or trigger phrases like: "I've decided", "let's use", "we're going with", "I learned", "turns out", "TIL", "discovered", "I'm stuck", "blocked by", "always use", "never do", "convention is". Also triggers on recall…

modeled-information-format/mnemonic · 109 tokens

format

MIF (Modeled Information Format) 1.4.2 Level 3 memory templates and formatting guidelines.

modeled-information-format/mnemonic · 24 tokens

custodian

Memory system custodian for health checks, validation, and maintenance. Trigger phrases: "check memory health", "validate memories", "fix broken links", "update decay", "relocate memories", "audit memories", "memory maintenance", "custodian", "memory health".

modeled-information-format/mnemonic · 58 tokens

ontology

Ontology-based entity discovery and validation for mnemonic memories. Define custom namespaces, entity types, traits, and relationships. Triggers: "entity discovery", "validate ontology", "define namespaces", "resolve entity references", "list ontologies", "show namespaces", "entity types", "entity relationships"…

modeled-information-format/mnemonic · 74 tokens