Skip to content
OntoSkills

Getting Started

OntoSkills ships as a product suite with three pieces:

  • ontoskills - the user-facing CLI
  • ontomcp - the local MCP runtime
  • ontocore - the optional compiler for source skills

The official registry is built in by default. Third-party registries can be added explicitly.

Prerequisites

  • Node.js 18+ for the ontoskills CLI
  • Git for source imports
  • Optional: Python 3.10+ if you install ontocore

Installation

Terminal window
npx ontoskills install mcp
npx ontoskills install core

This creates a managed user home under ~/.ontoskills/ with:

  • bin/ontomcp
  • core/ for the compiler runtime, if installed
  • ontoskills/ for compiled ontology packages
  • state/ for lockfiles and registry metadata

Common Commands

Terminal window
ontoskills init-core
ontoskills compile
ontoskills compile my-skill
ontoskills query "SELECT ?s WHERE { ?s a oc:Skill }"
ontoskills list-skills
ontoskills security-audit

If you only want the runtime and the published skills, you do not need the compiler commands.

Registry Workflow

Built-In Official Registry

The official registry is already available to ontoskills. You can discover and install published skills without any extra setup.

Terminal window
npx ontoskills search hello
npx ontoskills install marea.greeting/hello
npx ontoskills enable marea.greeting/hello

Third-Party Registries

Terminal window
ontoskills registry add-source acme https://example.com/index.json
ontoskills registry list

Import Source Skills

Raw repositories containing SKILL.md files can be imported and compiled locally:

Terminal window
ontoskills import-source-repo https://github.com/nextlevelbuilder/ui-ux-pro-max-skill

Imported source skills are stored under ~/.ontoskills/skills/vendor/ and compiled outputs land in ~/.ontoskills/ontoskills/vendor/.

MCP Server

OntoMCP exposes compiled ontologies via the Model Context Protocol.

Terminal window
npx ontoskills install mcp

The current public tool set is:

  • search_skills
  • get_skill_context
  • evaluate_execution_plan
  • query_epistemic_rules

Client-specific setup guides:

What’s Next?

  • CLI — Full command surface and product workflows
  • Marketplace — Search and install published skills
  • Compiler — Install the optional compiler
  • Skill Authoring — Import and compile source repositories
  • Registry — Install, update, remove, and uninstall skills
  • Troubleshooting — Diagnose install and runtime issues
  • Roadmap — See what’s coming
  • GitHub — Contribute