okf-site-kit

The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY in this skill are to be interpreted as described in BCP 14 (RFC 2119, RFC 8174) when, and only when, they appear in all capitals.

Generate a browsable website from an Open Knowledge Format bundle. OKF (Google's open spec for agent-readable knowledge) deliberately ships no required tooling — a bundle is just markdown with YAML frontmatter — which means "browsable" is left to consumers. This skill is that consumer: assets/okf_site.py (stdlib-only) reads any OKF bundle and emits a complete Astro + Starlight static-site project with search, navigation, and OKF-aware presentation. The bundle stays the canonical knowledge; the site is a generated view of it, regenerated whenever the bundle changes.

Locating this skill's helpers (do this first). The steps below run bundled scripts. You execute from the target repo, not from this skill's directory, so a path written relative to this skill will not resolve. Resolve the base directory once and use it everywhere — including in any subagent prompt, which MUST receive the literal absolute path: