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
Install
npx skills add longsizhuo/okf-frontmatter --skill okf-frontmattergit 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-frontmatterPersonal 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:
Details
- Skill name
okf-frontmatter- Repository
- longsizhuo/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
43clawnify/OpenProspector
Run a saved custom prospecting prompt and record evidence-backed Person or Company signals. Not for the four LinkedIn templates.
Ielts Writing
63liqianiiii/Awesome-ielts-claude-skills
雅思写作批改教练 v3.0。四维评分 + 句子级标注 + 改写对比 + 审题检查 + 数据持久化。 触发方式:/ielts-writing、「批改作文」「帮我看看这篇」「审题」「写作练习」
Ig Publish
67postzen-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.
Twitter Thread
69az9713/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.
Linkedin Signals
43clawnify/OpenProspector
Check a saved LinkedIn monitor and record attributable engagement for ICP review.
Thought Leadership
69az9713/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.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.