{{vault_name}}
Bundle OKF 0.2 · 0 conceitos · jotafurtado/okf-wiki-skills
Open source Repository Open in the app JSON README (API)
About
# {{vault_name}}
Details
- Kind
- OKF bundles
- Topic
- Productivity
- Publisher
- jotafurtado
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Last push
- 2026-08-22T19:31:14Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-09-08 02:26:02
- Updated
- 2026-09-08 02:26:02
- Origin id
jotafurtado/okf-wiki-skills:skills/okf-wiki-setup/assets/vault/wiki/index.md
README
# OKF Wiki Skills An agent-ready framework for a personal LLM Wiki that combines the operational flow of a maintained knowledge base with the portability and structural rigor of the [Open Knowledge Format (OKF)](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf). It is designed for private, Git-backed Obsidian vaults. The framework supports Codex and Claude Code from the start while keeping its core rules agent-independent. ## Architecture ```text sources/ → wiki/ → outputs/ immutable OKF deliverables inputs bundle ``` - `sources/` stores immutable originals, web captures, conversions, transcripts, and reviewed AI-assisted knowledge notes. - `wiki/` is the agent-maintained OKF bundle. It contains concepts, governance, `index.md`, and a newest-first dated `log.md`. - `outputs/` holds reports, emails, and other directed material. Outputs never become durable knowledge without explicit user approval.  The flow starts by capturing immutable sources, turns that material into governed concepts in the OKF Wiki, and produces answers or directed deliverables on demand. An approved synthesis returns directly to the wiki, preserving traceability from source to durable conclusion. Outputs do not become sources merely by being produced. When an output contains new evidence or an approved decision worth preserving, capture its original as a new source and then ingest it. A synthesis based only on existing sources is saved as a governed wiki page instead. Existing vault governance controls the taxonomy, profiles, sensitivity policy, and relationship vocabulary. Framework invariants—immutable sources, required types, traceability, valid links, and explicit contradiction handling—cannot be weakened locally. ## Skills - `okf-wiki-capture` captures immutable source material before ingestion. - `okf-wiki-ingest` compiles sources into governed, linked OKF concepts. - `okf-wiki-query` answers questions from the wiki without persisting results by default. - `okf-wiki-lint` audits OKF conformance, governance, links, provenance, and knowledge health. - `okf-wiki-governance` manages local taxonomy and profiles. - `okf-wiki-setup` bootstraps, adopts, and safely updates a governed vault. ## Installation Install every skill in this repository with the [`skills` CLI](https://github.com/vercel-labs/skills): ```bash npx skills add jotafurtado/okf-wiki-skills ``` To install only one skill, append its name to the repository source: ```bash npx skills add jotafurtado/okf-wiki-skills@okf-wiki-capture ``` To install only the vault bootstrapper: ```bash npx skills add jotafurtado/okf-wiki-skills@okf-wiki-setup ``` ## Design principles - **Human-curated, agent-maintained:** the agent manages compiled wiki content and preserves explicit human notes. - **Evidence before synthesis:** sources remain immutable; claims retain source links and precise locators when available. - **Small types, extensible profiles:** a controlled taxonomy describes the shape of knowledge, while profiles add domain-specific structure. - **No silent conflict resolution:** competing claims stay visible until an objective source or an explicit user decision supersedes one. - **Private by default:** the framework repository contains only documentation, templates, and synthetic fixtures—never vault content. ## Repository layout ```text docs/ Method, current ADRs, historical decisions, and current intent fixtures/ Synthetic vault fixtures skills/ Agent Skills packages, including distributed assets and scripts ``` Read [the method](docs/method.md), [current ADRs](docs/adr/), and the [historical architecture decisions](docs/decisions/) before adapting the framework. Current readiness and next-work notes live in [docs/intent](docs/intent/). The repository is currently in a pilot phase. ## Acknowledgements - **Open Knowledge Format (OKF):** this project independently implements a workflow compatible with the OKF v0.2 specification published in [GoogleCloudPlatform/knowledge-catalog](https://github.com/GoogleCloudPlatform/knowledge-catalog). That repository is licensed under Apache-2.0. - **Second Brain:** the `sources → wiki → outputs` operational model and the capture/ingest/query/lint split were informed by [NicholasSpisak/second-brain](https://github.com/NicholasSpisak/second-brain), itself based on the LLM Wiki pattern. Its repository does not currently declare a license; this project does not redistribute its code or text and expresses its workflow independently. ## License Licensed under the [Apache License, Version 2.0](LICENSE). Derivative works must preserve the applicable copyright, license, and attribution notices; see [NOTICE](NOTICE).