onemira-okf-skills
Zero-dependency Open Knowledge Format (OKF v0.2) Markdown validator, relational wiki-link graph builder & VTT/SRT transcript CLI for Obsidian, Claude MCP & OneMira
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 17 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/onemira-space/okf-markdown with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/onemira-space/okf-markdown'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/onemira-space--okf-markdown)HTML
<a href="/listings/onemira-space--okf-markdown"><img src="/api/listings/onemira-space--okf-markdown/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
brew tap onemira-space/tap brew install okf-markdown
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
- {
- "name": "onemira-okf-skills",
- "owner": {
- "name": "OneMira",
- "url": "https://onemira.com"
- },
- "plugins": [
- {
- "name": "okf-markdown",
- "source": "./",
- "description": "Validate Open Knowledge Format (OKF v0.2) Markdown vaults, convert VTT/SRT meeting transcripts, and build [[wiki-link]] knowledge graphs.",
- "version": "1.2.1"
- }
- ]
- }
README.md · README · 96 lines
- # okf-markdown
- Zero-dependency Node.js CLI and ESM library for validating **Open Knowledge Format (OKF v0.2)** Markdown vaults, building relational knowledge graphs (`[[wiki-links]]` + relative Markdown links), and converting `.vtt` / `.srt` / speaker-labeled transcripts into deterministic OKF session notes.
- Designed for local-first AI knowledge workflows across **Obsidian**, **Claude Code / Claude Desktop (MCP)**, **Cursor**, and **[OneMira C1](https://onemira.com/products/c1)**.
- ### Install via Homebrew (macOS & Linux)
- ```bash
- brew tap onemira-space/tap
- brew install okf-markdown
- ```
- ## Install as an AI Agent Skill (Claude Code, Cursor, Codex, Gemini CLI)
- ```bash
- # Universal Agent Skills CLI (skills.sh)
- npx skills add onemira-space/okf-markdown
- # Or in Claude Code interactive session:
- # /plugin marketplace add onemira-space/okf-markdown
- # /plugin install okf-markdown@onemira-okf-skills
- ```
- ## Quick Start (Zero Install via `npx`)
- ```bash
- # 1. Convert a WebVTT or SRT meeting transcript into an OKF v0.2 Markdown session note
- npx github:onemira-space/okf-markdown ingest ./meeting.vtt \
- --title "Q4 Product Architecture Review" \
- --out ./vault/sessions/q4-architecture.md
- # 2. Validate YAML frontmatter schema & relational link integrity across an Obsidian / OKF folder
- npx github:onemira-space/okf-markdown validate ./vault
- # 3. Export a structured JSON knowledge graph (nodes, edges, orphan notes) for RAG or MCP agents
- npx github:onemira-space/okf-markdown graph ./vault --out ./graph.json
- ```
- ## Python 3 Quick Start (`pip`)
- ```bash
- pip install git+https://github.com/onemira-space/okf-markdown.git
- okf-py ingest ./meeting.vtt --title "Q4 Architecture Review" > session.md
- okf-py validate session.md
- ```
- ## Programmatic ESM API
- ```js
- import {
- parseFrontmatter,
- validateOkfDocument,
- buildKnowledgeGraph,
- convertTranscriptToOkf,
- } from 'okf-markdown';
- const { markdown, speakers, turnCount } = convertTranscriptToOkf(vttString, {
- title: 'Design Critique',
- });
- const graph = buildKnowledgeGraph('./vault');
- console.log(graph.stats); // { files, edges, schemaErrors, brokenLinks, orphans }
- ```
- ## OKF v0.2 Frontmatter Schema
- Every OKF Markdown note begins with deterministic YAML frontmatter so local LLMs, CLI tools, and MCP servers can traverse context without proprietary cloud databases:
- ```yaml
- ---
- okf_version: "0.2"
- id: "session/q4-architecture"
- type: "session" # session | meeting | topic | person | project | decision | note
- title: "Q4 Product Architecture Review"
- created_at: "2026-11-16T12:00:00Z"
- speakers: ["Maya Lin", "Alex Rivera"]
- tags: ["architecture", "local-ai"]
- ---
- ```
- ## Related Documentation & Hardware Ecosystem
- - **[OneMira C1 Standalone AI Voice Recorder](https://onemira.com/products/c1)** — Single-press standalone capture, 99-language local transcription, Speaker ID, Local AI summaries ($0/month), and native OKF Markdown Wiki.
- - **[Local Wiki & OKF Architecture Guide](https://onemira.com/docs/daily-use/local-wiki)** — How compounding meeting memory is structured on macOS and Windows.
- - **[MCP & CLI Integration Guide](https://onemira.com/docs/mcp-integration)** — Connecting local meeting Markdown to Claude, ChatGPT, and Cursor.
- - **[Obsidian & Local Markdown Voice Workflow](https://onemira.com/blogs/ai-voice-recorder-for-obsidian-and-local-markdown)** — Using standalone voice capture with an Obsidian vault.
- - **[Voice Recorder for Note-Taking Guide](https://onemira.com/voice-recorder-for-note-taking)** — Practical workflow from spoken meetings to structured Markdown notes.
- ### Regional & Multilingual OKF Note-Taking Guides
- - [UK Dictaphone & Local Note-Taking Guide](https://onemira.com/en-gb/voice-recorder-for-note-taking) · [DE: KI-Diktiergerät für Notizen](https://onemira.com/de/voice-recorder-for-note-taking) · [FR: Dictaphone IA Prise de Notes](https://onemira.com/fr/voice-recorder-for-note-taking) · [IT: Registratore Vocale IA per Appunti](https://onemira.com/it/voice-recorder-for-note-taking) · [ES: Grabadora de Voz IA para Notas](https://onemira.com/es/voice-recorder-for-note-taking)
- ## License
- MIT © [OneMira](https://onemira.com)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.