ontology-docs

A standalone documentation dataset demonstrating Ontology's native executable, JSON/MCP interface, original image and discoverable/exportable Agent Skills.

cargo install ontology-docs
ontology-docs
ontology-docs search 'password protection'
ontology-docs images
ontology-docs skills list
ontology-docs skills read ontology-authoring
ontology-docs skills export ontology-authoring --output ./agent-skills
ontology-docs mcp-config

Normal commands return {ok,command,data,next} JSON; follow the actual next argv arrays for cited reads, image fetches and skill export. --human opts into text. serve is newline-delimited stdio MCP. No runtime files, network, compiler or embedding service is needed. This is a target-specific native executable, with normal platform runtime requirements. WASM is future work.

The committed data/docs.ontology fixture contains portable ontology:// provenance, the root README, format/agent/HTTP/ACP packaging and Notes guides, an original 32x24 gold/teal PNG, and three skills: ontology-skill-creator, ontology-authoring and ontology-docs-use. The grid was created directly from alternating RGB blocks; it has no third-party image source. Runtime image embeddings are deliberately absent; import aligned external vectors when needed rather than claim a bundled diffusion encoder.

Regenerate from the repository root after updating docs or skills:

cargo run --example generate_docs --locked
cargo build -p ontology-docs --release --locked

The Rust generator uses library builders and the native skill linter. The binary includes the resulting fixture with include_bytes; generation runs only while authoring the crate, never on installation or at runtime. Export writes the chosen ROOT/skill-name and does not install skills or change harness configuration.

ontology-docs server --port 0 launches the embedded dashboard and shared HTTP API. The demo includes current competition/usage guides, original binary bytes and a nested package; explore objects, graph, embeddings and packages.