{
  "markdown": "# OKF Wiki Skills\n\nAn agent-ready framework for a personal LLM Wiki that combines the operational\nflow of a maintained knowledge base with the portability and structural rigor\nof the [Open Knowledge Format (OKF)](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf).\n\nIt is designed for private, Git-backed Obsidian vaults. The framework supports\nCodex and Claude Code from the start while keeping its core rules\nagent-independent.\n\n## Architecture\n\n```text\nsources/  →  wiki/  →  outputs/\nimmutable     OKF       deliverables\n inputs       bundle\n```\n\n- `sources/` stores immutable originals, web captures, conversions,\n  transcripts, and reviewed AI-assisted knowledge notes.\n- `wiki/` is the agent-maintained OKF bundle. It contains concepts,\n  governance, `index.md`, and a newest-first dated `log.md`.\n- `outputs/` holds reports, emails, and other directed material. Outputs never\n  become durable knowledge without explicit user approval.\n\n![OKF Wiki Skills workflow](assets/okf-wiki-flow.png)\n\nThe flow starts by capturing immutable sources, turns that material into\ngoverned concepts in the OKF Wiki, and produces answers or directed\ndeliverables on demand. An approved synthesis returns directly to the wiki,\npreserving traceability from source to durable conclusion.\n\nOutputs do not become sources merely by being produced. When an output contains\nnew evidence or an approved decision worth preserving, capture its original as\na new source and then ingest it. A synthesis based only on existing sources is\nsaved as a governed wiki page instead.\n\nExisting vault governance controls the taxonomy, profiles, sensitivity policy,\nand relationship vocabulary. Framework invariants—immutable sources, required\ntypes, traceability, valid links, and explicit contradiction handling—cannot be\nweakened locally.\n\n## Skills\n\n- `okf-wiki-capture` captures immutable source material before ingestion.\n- `okf-wiki-ingest` compiles sources into governed, linked OKF concepts.\n- `okf-wiki-query` answers questions from the wiki without persisting results\n  by default.\n- `okf-wiki-lint` audits OKF conformance, governance, links, provenance, and\n  knowledge health.\n- `okf-wiki-governance` manages local taxonomy and profiles.\n- `okf-wiki-setup` bootstraps, adopts, and safely updates a governed vault.\n\n## Installation\n\nInstall every skill in this repository with the\n[`skills` CLI](https://github.com/vercel-labs/skills):\n\n```bash\nnpx skills add jotafurtado/okf-wiki-skills\n```\n\nTo install only one skill, append its name to the repository source:\n\n```bash\nnpx skills add jotafurtado/okf-wiki-skills@okf-wiki-capture\n```\n\nTo install only the vault bootstrapper:\n\n```bash\nnpx skills add jotafurtado/okf-wiki-skills@okf-wiki-setup\n```\n\n## Design principles\n\n- **Human-curated, agent-maintained:** the agent manages compiled wiki content\n  and preserves explicit human notes.\n- **Evidence before synthesis:** sources remain immutable; claims retain source\n  links and precise locators when available.\n- **Small types, extensible profiles:** a controlled taxonomy describes the\n  shape of knowledge, while profiles add domain-specific structure.\n- **No silent conflict resolution:** competing claims stay visible until an\n  objective source or an explicit user decision supersedes one.\n- **Private by default:** the framework repository contains only documentation,\n  templates, and synthetic fixtures—never vault content.\n\n## Repository layout\n```text\ndocs/        Method, current ADRs, historical decisions, and current intent\nfixtures/    Synthetic vault fixtures\nskills/      Agent Skills packages, including distributed assets and scripts\n```\n\nRead [the method](docs/method.md), [current ADRs](docs/adr/), and the\n[historical architecture decisions](docs/decisions/) before adapting the\nframework. Current readiness and next-work notes live in\n[docs/intent](docs/intent/). The repository is currently in a pilot phase.\n\n## Acknowledgements\n\n- **Open Knowledge Format (OKF):** this project independently implements a\n  workflow compatible with the OKF v0.2 specification published in\n  [GoogleCloudPlatform/knowledge-catalog](https://github.com/GoogleCloudPlatform/knowledge-catalog).\n  That repository is licensed under Apache-2.0.\n- **Second Brain:** the `sources → wiki → outputs` operational model and the\n  capture/ingest/query/lint split were informed by\n  [NicholasSpisak/second-brain](https://github.com/NicholasSpisak/second-brain),\n  itself based on the LLM Wiki pattern. Its repository does not currently\n  declare a license; this project does not redistribute its code or text and\n  expresses its workflow independently.\n\n## License\n\nLicensed under the [Apache License, Version 2.0](LICENSE). Derivative works\nmust preserve the applicable copyright, license, and attribution notices; see\n[NOTICE](NOTICE).\n",
  "bytes": 4832,
  "sha": "19e445471fbe4418cb1531d1d64f56d308d9ae1f277300c981b20a219e0ee364",
  "repo_slug": "jotafurtado/okf-wiki-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_jotafurtado_okf_wiki_skills_skills_okf_w_cbb82553/readme"
}