{"repo":"longsizhuo/okf-frontmatter","free":true,"listed":false,"github":"https://github.com/longsizhuo/okf-frontmatter","clone":"git clone https://github.com/longsizhuo/okf-frontmatter.git","description":"skill: maintain repo docs under the Open Knowledge Format + fast doc/schema lookup (find_docs.py). Grep-first, script-fallback.","language":"Python","stars":43,"topics":["docs","markdown","skill","skills"],"license":"MIT","category":"cli-tools","readme_excerpt":"okf-frontmatter Keep a repo's Markdown docs under the Open Knowledge Format — and find the right doc/schema fast.  ·  pure-Python stdlib  ·  portable agent skill — Claude Code / Codex / any --- Table of contents - What it is - Install - Claude Code - Codex - Any other agent - Background - Does it actually help? I measured it. - CLI usage - Commands - Frontmatter schema - Layout - License --- What it is okf-frontmatter is a portable agent skill: just a SKILL.md plus a small script, so any agent that loads skills can pick it up (or you can run it as a plain CLI). It does two things. Keeps docs in OKF shape. Each doc opens with a little YAML frontmatter — type , title , tags , intent , schema source , documents . The parts that are code — models, config keys, endpoints — get a schema source: file.py:Symbol pointer instead of being retyped into prose. So docs stop drifting from the code and stop ballooning into thousand-line walls. Finds the right doc fast. Hand find docs.py a symbol, an endpoint, a config key, or just a keyword, and it ranks the doc that actually owns the topic (by frontmatter intent). schema goes one step further and resolves those pointers straight to the code, so the agent reads the authoritative definition without opening the prose at all. One thing I want to be straight about: this is grep-first . The script isn't a replacement for grep — it's what you reach for when grep is ambiguous (hits scattered across files, a synonym mismatch, or ","default_branch":null,"files":null,"tree":[],"storefront":"/r/longsizhuo","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/longsizhuo/okf-frontmatter/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}