Skip to content
Back to search

onemira-okf-skills

MarketplaceWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/onemira-space--okf-markdown/badge.svg)](/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
  1. {
  2. "name": "onemira-okf-skills",
  3. "owner": {
  4. "name": "OneMira",
  5. "url": "https://onemira.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "okf-markdown",
  10. "source": "./",
  11. "description": "Validate Open Knowledge Format (OKF v0.2) Markdown vaults, convert VTT/SRT meeting transcripts, and build [[wiki-link]] knowledge graphs.",
  12. "version": "1.2.1"
  13. }
  14. ]
  15. }
README.md · README · 96 lines
  1. # okf-markdown
  2. 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.
  3. Designed for local-first AI knowledge workflows across **Obsidian**, **Claude Code / Claude Desktop (MCP)**, **Cursor**, and **[OneMira C1](https://onemira.com/products/c1)**.
  4. ### Install via Homebrew (macOS & Linux)
  5. ```bash
  6. brew tap onemira-space/tap
  7. brew install okf-markdown
  8. ```
  9. ## Install as an AI Agent Skill (Claude Code, Cursor, Codex, Gemini CLI)
  10. ```bash
  11. # Universal Agent Skills CLI (skills.sh)
  12. npx skills add onemira-space/okf-markdown
  13. # Or in Claude Code interactive session:
  14. # /plugin marketplace add onemira-space/okf-markdown
  15. # /plugin install okf-markdown@onemira-okf-skills
  16. ```
  17. ## Quick Start (Zero Install via `npx`)
  18. ```bash
  19. # 1. Convert a WebVTT or SRT meeting transcript into an OKF v0.2 Markdown session note
  20. npx github:onemira-space/okf-markdown ingest ./meeting.vtt \
  21. --title "Q4 Product Architecture Review" \
  22. --out ./vault/sessions/q4-architecture.md
  23. # 2. Validate YAML frontmatter schema & relational link integrity across an Obsidian / OKF folder
  24. npx github:onemira-space/okf-markdown validate ./vault
  25. # 3. Export a structured JSON knowledge graph (nodes, edges, orphan notes) for RAG or MCP agents
  26. npx github:onemira-space/okf-markdown graph ./vault --out ./graph.json
  27. ```
  28. ## Python 3 Quick Start (`pip`)
  29. ```bash
  30. pip install git+https://github.com/onemira-space/okf-markdown.git
  31. okf-py ingest ./meeting.vtt --title "Q4 Architecture Review" > session.md
  32. okf-py validate session.md
  33. ```
  34. ## Programmatic ESM API
  35. ```js
  36. import {
  37. parseFrontmatter,
  38. validateOkfDocument,
  39. buildKnowledgeGraph,
  40. convertTranscriptToOkf,
  41. } from 'okf-markdown';
  42. const { markdown, speakers, turnCount } = convertTranscriptToOkf(vttString, {
  43. title: 'Design Critique',
  44. });
  45. const graph = buildKnowledgeGraph('./vault');
  46. console.log(graph.stats); // { files, edges, schemaErrors, brokenLinks, orphans }
  47. ```
  48. ## OKF v0.2 Frontmatter Schema
  49. Every OKF Markdown note begins with deterministic YAML frontmatter so local LLMs, CLI tools, and MCP servers can traverse context without proprietary cloud databases:
  50. ```yaml
  51. ---
  52. okf_version: "0.2"
  53. id: "session/q4-architecture"
  54. type: "session" # session | meeting | topic | person | project | decision | note
  55. title: "Q4 Product Architecture Review"
  56. created_at: "2026-11-16T12:00:00Z"
  57. speakers: ["Maya Lin", "Alex Rivera"]
  58. tags: ["architecture", "local-ai"]
  59. ---
  60. ```
  61. ## Related Documentation & Hardware Ecosystem
  62. - **[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.
  63. - **[Local Wiki & OKF Architecture Guide](https://onemira.com/docs/daily-use/local-wiki)** — How compounding meeting memory is structured on macOS and Windows.
  64. - **[MCP & CLI Integration Guide](https://onemira.com/docs/mcp-integration)** — Connecting local meeting Markdown to Claude, ChatGPT, and Cursor.
  65. - **[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.
  66. - **[Voice Recorder for Note-Taking Guide](https://onemira.com/voice-recorder-for-note-taking)** — Practical workflow from spoken meetings to structured Markdown notes.
  67. ### Regional & Multilingual OKF Note-Taking Guides
  68. - [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)
  69. ## License
  70. MIT © [OneMira](https://onemira.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.