When to use this skill
- Use for Open Ontologies CLI/MCP operation: inspect RDF/OWL inputs, validate syntax or SHACL, plan semantic changes, reason/query, compare/diff, or verify certificates with the project's checker.
- Use when the user names
open-ontologies,oo-cert, anonto_*MCP tool, or asks for change-impact, entailment, provenance, or certified ontology results. - Route visual ontology editing/class-hierarchy authoring to Protégé or
orionbelt-ontology-builder; route general document-to-graph pipelines, extraction, or vector/backend integration tosemantica. - Route generic database administration, hosted-provider setup, or unrelated RDF tooling to the matching platform skill; this package does not replace those operators.
Instructions
- Start with the bundled offline source check, before reading or running an upstream binary:
- From the
jeo-skillsrepository root:python3 .agent-skills/open-ontologies/scripts/preflight.py --repo /absolute/path/to/upstream --json - From an installed
open-ontologiesskill root:python3 scripts/preflight.py --repo /absolute/path/to/upstream --jsonUse an authorized absolute source directory with no symlink path components. Exit0plussource_checked: truemeans only the manifest-listed public-file hashes matched;1means a listed file is missing or mismatched;2means invalid, unsafe, or unreadable input. A report is never runtime proof:runtime_verifiedstaysfalse.
- From the
- Identify the intended backend and exact ontology inputs. Inspect current source files and scope before planning; do not write/apply a plan without explicit authorization for that data and destination.
- Use the installed binary's own
--helpfor exact subcommands and flags. The pinned README demonstratesprintf 'load base.ttl\\nplan proposed.ttl\\n' | open-ontologies batch -; treat it as an example, not a command to run without input review. - Keep evidence classes separate: engine result, supplied-rule result, prover opinion, and independently checked certificate are not interchangeable. Report unknown, incomplete, unsupported constructs, and budget exhaustion as such, never as a negative answer or complete proof.
- Before MCP setup or any runtime command, obtain approval for the exact install/build/download, client registration, listener bind/auth, remote data access, provider call, graph/database mutation, or public deployment. Inspect transport and client scope first; stdio package metadata and source
serve-httpare different exposure modes. - Preserve the helper's scope: it uses only Python stdlib and selected-file hashing, with PATH discovery for
python3; it does not execute upstream code, use the network, read secret files, verify Git HEAD, verify dependencies, or establish runtime readiness.
Examples
- “Compare these two RDF files and show semantic consequences before I apply anything.”
- “Check whether this entailment has a certificate and distinguish undecided from false.”
- “Configure the Open Ontologies MCP server for my editor.”
Best practices
- Use
oo-certonly on the assertion/derivation artifacts it is intended to check, and preserve its exit status and verdict text. - Planning or a successful validation does not mutate production data; applying, importing, or writing artifacts is a separate approval boundary.
- Read
references/upstream.mdand verify the matching pinned source before choosing exact flags. The offline helper checks selected file hashes only, not Git HEAD or runtime readiness.
Completion
- Report the mode used (
offline-selected-files, CLI, stdio MCP, or HTTP MCP), exact source evidence consumed, approval boundary crossed, and observed result. - Claim runtime readiness only after a separately approved run of the installed binary/client; never promote a selected-file hash match, tool presence, or source inspection into runtime proof.
References
references/upstream.md- setup, command families, scope limits, license, safety.references/source.json- selected pinned file SHA256s; not a whole-revision attestation.evals/evals.json- authored routing and boundary scenarios, not executed model-quality tests.