Skip to main content

OntoCore — Neuro-symbolic skill compiler. Compiles SKILL.md into validated OWL 2 ontologies.

Project description

OntoCore

Deterministic AI Skills via OWL 2 Ontologies

The neuro-symbolic compiler for the OntoSkills platform.

Compile natural language skills into verified, queryable knowledge graphs —
an alternative to probabilistic agent skills with a lightning-fast Rust MCP.

PyPI version Python versions OWL 2 License


What is OntoCore?

OntoCore is the Python compiler at the heart of the OntoSkills platform. It acts as a neuro-symbolic compiler that transforms unstructured, human-readable AI skills (SKILL.md) into strictly validated, queryable OWL 2 ontologies.

By combining the natural language understanding of LLMs with the deterministic formal logic of RDF and SHACL validation, OntoCore ensures that AI agents operate on exact, verifiable knowledge graphs rather than probabilistic prompts.

Key Capabilities

  • LLM Knowledge Extraction: Extracts structured triples (Dependencies, Inputs, Intents, Operations) from markdown files.
  • SHACL Validation: Ensures the extracted semantic graph strictly adheres to the OntoSkills Core Ontology.
  • OWL 2 Compilation: Outputs self-contained .ttl (Turtle) graphs ready for deterministic SPARQL querying.
  • Local Registry Management: Handles the installation, enabling, and indexing of distributed skills packages.
  • Security Auditing: Analyzes the graph for conflicting intents, missing dependencies, or shadowed skills.

Installation

Install the compiler directly from PyPI (requires Python 3.10+):

pip install ontocore

Quick Start

1. Initialize the Environment

Create the necessary folder structure (.ontoskills/) in your project:

ontocore init-core

2. Configure the LLM

OntoCore needs an LLM to extract relationships. Create a .env file or export the keys:

export OPENAI_API_KEY="sk-..."

(Anthropic is also supported via ANTHROPIC_API_KEY)

3. Compile Skills

Assuming you have SKILL.md files in a skills/ directory, run the compiler:

ontocore compile

This will read the markdown files, extract knowledge, validate it via SHACL, and generate .ttl ontology files in the .ontoskills/ output directory.

4. Query the Knowledge Graph

You can perform exact graph queries using SPARQL directly from the CLI:

ontocore query "SELECT ?skill WHERE { ?skill oc:resolvesIntent 'create_pdf' }"

CLI Reference

The package provides the ontocore command-line tool. Here are the main commands:

Core Commands

  • ontocore compile: Compile local skills to validated OWL 2 ontologies.
  • ontocore query <sparql_query>: Execute a SPARQL query against the compiled domain graph.
  • ontocore security-audit: Run security checks against the knowledge graph to find issues.
  • ontocore init-core: Initialize an empty OntoSkills registry in the current directory.
  • ontocore list-skills: List all successfully compiled skills in the domain graph.

Registry & Packages

  • ontocore install-package <path>: Install a .tar.gz skill package.
  • ontocore import-source-repo <url>: Import skills directly from a remote Git repository.
  • ontocore install: Download and install all dependencies declared in the lockfile.
  • ontocore enable <skill_id>: Enable an installed skill.
  • ontocore disable <skill_id>: Disable an installed skill.
  • ontocore list-installed: Show all installed packages and their status.
  • ontocore rebuild-index: Rebuild the registry index manually.

Run ontocore --help or ontocore <command> --help for detailed usage.


Documentation & Source

For the full documentation, architecture details, and to contribute to the project, please visit the main repository:

👉 mareasw/ontoskills GitHub Repository


© 2026 Marea Software

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ontocore-0.10.0.tar.gz (108.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ontocore-0.10.0-py3-none-any.whl (88.4 kB view details)

Uploaded Python 3

File details

Details for the file ontocore-0.10.0.tar.gz.

File metadata

  • Download URL: ontocore-0.10.0.tar.gz
  • Upload date:
  • Size: 108.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ontocore-0.10.0.tar.gz
Algorithm Hash digest
SHA256 117f145674ca3158b8f9653cfe950de7c8ff26f5ae687a570e4f57a1738d2faf
MD5 7edd250f6523d31064d2fe37390456fe
BLAKE2b-256 18d83880372983d3c6437884c8e7e7b8b46f4678ecd37aeced2c2412d9ee9650

See more details on using hashes here.

Provenance

The following attestation bundles were made for ontocore-0.10.0.tar.gz:

Publisher: release-core.yml on mareasw/ontoskills

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ontocore-0.10.0-py3-none-any.whl.

File metadata

  • Download URL: ontocore-0.10.0-py3-none-any.whl
  • Upload date:
  • Size: 88.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ontocore-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 97a9a0d34a18548cbe46785a1a6805abeec378d181edde8f71516fbffec1a11d
MD5 0de2cec5876970f2cdfb96878104cda8
BLAKE2b-256 f02d2c66d9aab0b9f3674ae43e2d7f7b041dc438b12f576cdb78dcddb7f4f048

See more details on using hashes here.

Provenance

The following attestation bundles were made for ontocore-0.10.0-py3-none-any.whl:

Publisher: release-core.yml on mareasw/ontoskills

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page