Skip to content

aalmada/agent-package-manager-extension / .agents/skills/okf

Produce, consume, validate, and navigate Open Knowledge Format (OKF) bundles. Use when: creating an OKF knowledge bundle; converting catalogs, wikis, schemas, metrics, runbooks, or APIs to OKF; parsing or indexing OKF; designing an OKF producer or consumer; validating OKF v0.2 conformance; traversing index.md files and concept links; minimizing agent context while reading OKF documentation; handling provenance, trust, lifecycle, sources, or Attested Computation concepts. DO NOT USE FOR: OpenAPI schemas; generic Markdown documentation with no OKF bundle; knowledge graphs that do not use OKF files; runtime packaging or serving protocols not defined by OKF.

Open Knowledge Format

OKF v0.2 represents portable knowledge as a directory tree of UTF-8 Markdown concept files with YAML frontmatter. The file path identifies the concept; index.md enables progressive disclosure; links form a graph.

Anatomy

FilePurposeTarget Size
SKILL.mdRouting, model, and workflow<100 lines
references/specification.mdLocal OKF v0.2 normative digest<200 lines
references/producer-guide.mdBundle design, authoring, and validation<200 lines
references/consumer-guide.mdParsing, trust, traversal, and attestation<200 lines
references/efficient-reading.mdLow-context progressive reading for humans and agents<200 lines

Core Model

ElementRule
BundleDirectory tree; git, archive, or repository subdirectory
ConceptAny non-reserved .md file; YAML frontmatter plus Markdown body
Concept IDBundle-relative file path without .md
Required metadataNon-empty type; all other fields are optional
Reserved filesindex.md for listings; log.md for chronological updates
RelationshipsStandard Markdown links; bundle-relative links are preferred
ExtensibilityProducers may add fields; consumers must tolerate unknown fields and types

Route The Task

GoalLoad
Check exact requirements or compatibilityspecification.md
Create, export, or maintain a bundleproducer-guide.md
Parse, search, render, or execute from a bundleconsumer-guide.md
Read a large bundle with minimal contextefficient-reading.md

Default Workflow

  1. Read the root index.md if present; otherwise list paths without opening bodies.
  2. Parse frontmatter first and select concepts by path, type, tags, lifecycle, and description.
  3. Open only selected bodies; follow links and sources when the task requires more evidence.
  4. Apply trust, freshness, and attestation rules without rejecting optional or unknown data.
  5. Preserve unknown metadata when rewriting; validate the conformance checklist before publishing.

Sources

SourceRole
OKF v0.2 specificationNormative source
Google Cloud introductionDesign rationale and v0.1 context

Reference Files

FileLoad When
references/specification.mdResolving normative fields, conformance, versioning, or v0.1 migration
references/producer-guide.mdDesigning and writing bundles or producer pipelines
references/consumer-guide.mdBuilding readers, indexes, search, UIs, or agents
references/efficient-reading.mdTraversing OKF documentation efficiently and selectively
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall