BeClaude

okf-author

New
GitHub TrendingDocumentationby parkscloud

Cross-agent Claude Code / Codex skill to author, convert, and validate Markdown in Open Knowledge Format (OKF).

First seen 6/21/2026

Summary

The okf-author skill enables Claude Code and Codex agents to author, convert, and validate Markdown documents in the Open Knowledge Format (OKF).

  • It helps developers maintain structured, standards-compliant documentation by automating format checks, cross-referencing, and transformation between OKF and other formats.

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/okf-author.md https://raw.githubusercontent.com/parkscloud/okf-author/main/SKILL.md
3
Invoke in Claude Code
/okf-author

Use Cases

Convert a raw Markdown file into OKF-compliant structure with proper frontmatter and sectioning.
Validate an existing OKF document against the schema to catch missing required fields or broken cross-references.
Author a new OKF knowledge entry from scratch by providing a title and key points.
Batch-convert a folder of legacy Markdown files to OKF format for a documentation migration.
Extract and list all cross-references within an OKF document to verify link integrity.
Generate a summary or table of contents from an OKF document's metadata and headings.

Usage Examples

1

/okf-author convert ./draft.md --output ./okf-doc.md

2

/okf-author validate ./knowledge-base/okf-article.md

3

Create a new OKF document about API authentication with sections for overview, endpoints, and examples.

View source on GitHub
agent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is okf-author?

The okf-author skill enables Claude Code and Codex agents to author, convert, and validate Markdown documents in the Open Knowledge Format (OKF). It helps developers maintain structured, standards-compliant documentation by automating format checks, cross-referencing, and transformation between OKF and other formats.

How to install okf-author?

To install okf-author: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/okf-author.md https://raw.githubusercontent.com/parkscloud/okf-author/main/SKILL.md. Finally, /okf-author in Claude Code.

What is okf-author best for?

okf-author is a skill categorized under Documentation. It is designed for: agent. Created by parkscloud.

What can I use okf-author for?

okf-author is useful for: Convert a raw Markdown file into OKF-compliant structure with proper frontmatter and sectioning.; Validate an existing OKF document against the schema to catch missing required fields or broken cross-references.; Author a new OKF knowledge entry from scratch by providing a title and key points.; Batch-convert a folder of legacy Markdown files to OKF format for a documentation migration.; Extract and list all cross-references within an OKF document to verify link integrity.; Generate a summary or table of contents from an OKF document's metadata and headings..