okf-manager

Enrich an OKF bundle from the web — fetch a bounded set of seed URLs, and for each page decide whether to augment an existing concept, add a new reference under references/, or skip. Use when the user says "enrich my bundle from these URLs", "pull in docs from <site>", "add web references", or "research and add sources for <concept>". Requires a domain allowlist and never crawls openly. For seeding from a local structured source (database, OpenAPI, repo), use the `seed` skill.

Import existing markdown into an OKF knowledge bundle — apply the capture filter, propose placement, fill in missing frontmatter, and wire it into the index. Use when the user says "import this note", "add this file to my bundle", "bring these markdown files in", or points at a loose .md file or folder. For authoring a concept from scratch, use the `new` skill.

Validate an OKF knowledge bundle — conformance (frontmatter + required type), broken cross-links, orphaned concepts, and staleness. Use when the user says "check my OKF bundle", "validate my knowledge base", "what's broken in my notes", or after importing or editing concepts.

Convert a non-markdown file into an OKF concept — turn a .txt/.html/.csv/.json file (or, via your own extraction, a PDF/docx) into one conformant markdown concept and wire it into the bundle. Use when the user says "convert this file", "turn this CSV/JSON/HTML into a note", "import this PDF into my knowledge base", or points at a non-markdown source. For loose markdown, use the `add` skill.

Search an OKF knowledge bundle by text, type, tag, or status — returns ranked concepts with their paths and the concepts they link to. Use when the user says "find notes about X", "search my knowledge base", "what do I have on Y", "list all <type> concepts", or "show concepts tagged Z".

Generate a self-contained HTML graph of an OKF knowledge bundle (no dependencies, opens in a browser). Use when the user says "visualize my knowledge base", "show me the map", "map my OKF bundle", or wants to see how concepts connect.

Rename or relocate a concept in an OKF bundle without breaking links — finds every backlink and surgically rewrites it to the new location, then updates the index. Use when the user says "rename this concept", "move this note to", "reorganize my bundle", or "relocate this file". Link-safe and non-destructive.

Scaffold a new concept in an OKF knowledge bundle from a plain-English description — pick the type, title, tags, and placement, then write a conformant file and wire it into the index. Use when the user says "add a concept", "new OKF note", or "create a knowledge file for". To bootstrap a brand-new bundle from scratch, use the `start` skill; for importing existing markdown, use the `add` skill.

Conventions for working inside an OKF knowledge bundle (a directory of markdown files with YAML frontmatter, plus reserved index.md/log.md). Use whenever reading, editing, or creating files in or near an OKF bundle — to preserve source formatting, keep links OKF-conformant, maintain the log, and apply trust tiers. Auto-applies when an okf.json or a bundle index.md is present.

Mine a repo or a PARA/notes folder for knowledge worth importing into an OKF bundle — list the candidate files, apply the capture filter, and propose what to import and where it belongs, nothing without confirmation. Use when the user says "scan this folder for notes to import", "what in this repo is worth capturing", "triage my notes into the bundle", or points at a folder of mixed files.

Seed an OKF bundle from a structured source — a SQLite database, an OpenAPI or JSON-Schema file, or a directory tree — minting one conformant concept per table, endpoint/definition, or file. Use when the user says "seed from", "import my database schema", "catalog this repo", "build concepts from this OpenAPI spec", or "generate a knowledge base from <source>". For importing one markdown file use `add`; for one non-markdown file use `convert`.

Guided onboarding for a new OKF knowledge bundle — a short interview, then scaffold a starter structure and walk the user through their first concepts. Use when the user says "start a knowledge base", "set up an OKF bundle", "onboard me to OKF", "I want a second brain", or has no bundle yet.