Okf Frontmatter

Maintain a repo's Markdown docs (wiki chapters, ADRs, references) under Google's Open Knowledge Format (OKF), and find the right doc/schema fast. Two jobs. (1) Maintain docs the OKF way — each doc carries a small YAML frontmatter block as the single source of truth (type, title, tags, intent, schema_source, documents); schema detail links to the authoritative code instead of being copied into prose, so docs stop drifting and stop ballooning into thousand-line Markdown. (2) Look docs up fast — grep the literal term FIRST; only when grep is ambiguous (hits scattered across files / synonym mismat

43 stars 3 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add longsizhuo/okf-frontmatter --skill okf-frontmatter
Manual install
git clone --depth 1 https://github.com/longsizhuo/okf-frontmatter.git /tmp/okf-frontmatter
mkdir -p ~/.claude/skills
cp -r /tmp/okf-frontmatter/. ~/.claude/skills/okf-frontmatter

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# okf-frontmatter

Your repo's Markdown docs (wiki chapters, ADRs, references) each start, under **OKF**, with a
YAML frontmatter block that is the *single source of truth* about that doc. Tooling reads the
frontmatter; humans read the prose. The goal: stop maintaining huge prose docs that duplicate
what the code already says — link to the code instead, and let `find_docs.py` do navigation.

Point the script at a repo with `--repo <path>`, or just run it from inside that repo (it
auto-detects the nearest ancestor containing `docs/wiki/`, else uses the working dir). It is
read-only except for docs you explicitly edit. The conventions below use openInvest as the
worked example, but the mechanics (`find` / `schema` / `lint`) work on any repo whose
markdown carries OKF frontmatter.

---

## Job 1 — maintain docs the OKF way

**The rule of thumb:** frontmatter is structured truth; prose is explanation. Anything that
*is* a schema (a Pydantic model, a dataclass, a config key, an endpoint contract) lives in
code — the doc **points** to it via `schema_source` / `documents`, it does not re-type it.
When the code changes, `lint` tells you which doc's pointer went stale. Don't grow a doc past
a few screens of "why / how it fits together"; if you're copying field tables out of code,
stop and add a `schema_source` pointer instead.

### Frontmatter schema

Common to every doc:
Read the full skill on GitHub

Details

Skill name
okf-frontmatter
License
MIT
Repo updated
30 June 2026

FAQ

What does the Okf Frontmatter skill do?

Maintain a repo's Markdown docs (wiki chapters, ADRs, references) under Google's Open Knowledge Format (OKF), and find the right doc/schema fast. Two jobs. (1) Maintain docs the OKF way — each doc carries a small YAML frontmatter block as the single source of truth (type, title, tags, intent, schema_source, documents); schema detail links to the authoritative code instead of being copied into prose, so docs stop drifting and stop ballooning into thousand-line Markdown. (2) Look docs up fast — grep the literal term FIRST; only when grep is ambiguous (hits scattered across files / synonym mismat

How do I install the Okf Frontmatter skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add longsizhuo/okf-frontmatter --skill okf-frontmatter. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Okf Frontmatter popular?

It lives in longsizhuo/okf-frontmatter, which has 43 GitHub stars and 3 forks.

Related skills

Custom Signals

43

clawnify/OpenProspector

Run a saved custom prospecting prompt and record evidence-backed Person or Company signals. Not for the four LinkedIn templates.

Writing & Content10

Ielts Writing

63

liqianiiii/Awesome-ielts-claude-skills

雅思写作批改教练 v3.0。四维评分 + 句子级标注 + 改写对比 + 审题检查 + 数据持久化。 触发方式:/ielts-writing、「批改作文」「帮我看看这篇」「审题」「写作练习」

Writing & Content

Ig Publish

67

postzen-dev/instagram-agent-skill

Publish, schedule or queue a finished Instagram post (feed, reel, carousel or story) through the PostZen MCP tools, verify it actually went out, and log it. Use when the user says "post it", "publish this", "schedule it for Tuesday", "put it in the queue", "connect my Instagram", or when another skill in this pack has a copy-ready block and the user wants it posted rather than pasted.

Writing & Content14

Twitter Thread

69

az9713/ai-co-writing-claude-skills

Create viral Twitter/X threads that educate, entertain, and grow your audience. Use when the user wants to write threads, needs to break down complex topics, or wants to repurpose long-form content into thread format.

Writing & Content12

Linkedin Signals

43

clawnify/OpenProspector

Check a saved LinkedIn monitor and record attributable engagement for ICP review.

Writing & Content10

Thought Leadership

69

az9713/ai-co-writing-claude-skills

Create thought leadership content including long-form articles, essays, and opinion pieces. Use when the user needs authoritative content, wants to establish expertise, or needs to articulate a unique perspective on industry topics.

Writing & Content12

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.