How it Works
From SKILL.md to deterministic execution in 4 simple steps
SKILL.md
Human-authored
Skills are authored in Markdown with YAML frontmatter. Developers write clear instructions, define intents, and structure content that AI agents can understand and execute.
- YAML frontmatter for metadata
- Markdown body for instructions
- Version-controlled with your code
- Human-readable, AI-friendly
---
name: tdd-workflow
description: Test-driven development
intents:
- write_tests_first
---
## Instructions
1. Write the test first
2. Run the test (it fails)
3. Write minimal code
4. Run the test (it passes)
5. Refactor OntoCore
The Compiler
OntoCore compiles SKILL.md files into OWL 2 DL ontologies. The compiler validates structure, extracts semantic relationships, and generates machine-readable RDF triples.
- Parses and validates SKILL.md
- Extracts semantic relationships
- Generates OWL 2 DL ontology
- SHACL validation built-in
$ npx ontoskills compile
Parsing tdd-workflow/SKILL.md...
Validating structure...
Generating ontology...
Writing triples...
✓ Compiled to ontoskills/tdd-workflow.ttl .ttl Files
The Ontology
The compiled Turtle (.ttl) files contain the ontology — a formal representation of skills, intents, and their relationships using RDF triples and OWL semantics.
- Standard RDF Turtle format
- OWL 2 DL definitions
- SPARQL-queryable graph
- Semantic skill relationships
@prefix oc: <https://ontoskills.dev/ns#> .
oc:tdd-workflow a oc:Skill ;
oc:name "tdd-workflow" ;
oc:description "Test-driven dev" ;
oc:resolvesIntent "write_tests_first" ;
oc:hasStep oc:write-test,
oc:run-test,
oc:implement . OntoMCP
The Runtime
OntoMCP is the Rust-based MCP runtime that loads ontologies and serves skill queries to AI agents through the Model Context Protocol with sub-millisecond response times.
- Native Rust performance
- MCP protocol implementation
- Sub-millisecond SPARQL
- Intent-based discovery
# Search by intent
search_intents("create_pdf")
→ pdf-generator
→ report-exporter
# Get skill context
get_skill("pdf-generator")
→ { name, description, instructions } Ready to compile your first skill?
Get started with OntoSkills in minutes. Write your first SKILL.md, compile it to an ontology, and query it through MCP.