aalmada/agent-package-manager-extension / .agents/skills/okf
okf
VerifiedProduce, 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
| File | Purpose | Target Size |
|---|---|---|
SKILL.md | Routing, model, and workflow | <100 lines |
references/specification.md | Local OKF v0.2 normative digest | <200 lines |
references/producer-guide.md | Bundle design, authoring, and validation | <200 lines |
references/consumer-guide.md | Parsing, trust, traversal, and attestation | <200 lines |
references/efficient-reading.md | Low-context progressive reading for humans and agents | <200 lines |
Core Model
| Element | Rule |
|---|---|
| Bundle | Directory tree; git, archive, or repository subdirectory |
| Concept | Any non-reserved .md file; YAML frontmatter plus Markdown body |
| Concept ID | Bundle-relative file path without .md |
| Required metadata | Non-empty type; all other fields are optional |
| Reserved files | index.md for listings; log.md for chronological updates |
| Relationships | Standard Markdown links; bundle-relative links are preferred |
| Extensibility | Producers may add fields; consumers must tolerate unknown fields and types |
Route The Task
| Goal | Load |
|---|---|
| Check exact requirements or compatibility | specification.md |
| Create, export, or maintain a bundle | producer-guide.md |
| Parse, search, render, or execute from a bundle | consumer-guide.md |
| Read a large bundle with minimal context | efficient-reading.md |
Default Workflow
- Read the root
index.mdif present; otherwise list paths without opening bodies. - Parse frontmatter first and select concepts by path,
type,tags, lifecycle, and description. - Open only selected bodies; follow links and
sourceswhen the task requires more evidence. - Apply trust, freshness, and attestation rules without rejecting optional or unknown data.
- Preserve unknown metadata when rewriting; validate the conformance checklist before publishing.
Sources
| Source | Role |
|---|---|
| OKF v0.2 specification | Normative source |
| Google Cloud introduction | Design rationale and v0.1 context |
Reference Files
| File | Load When |
|---|---|
| references/specification.md | Resolving normative fields, conformance, versioning, or v0.1 migration |
| references/producer-guide.md | Designing and writing bundles or producer pipelines |
| references/consumer-guide.md | Building readers, indexes, search, UIs, or agents |
| references/efficient-reading.md | Traversing OKF documentation efficiently and selectively |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 319k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |