Registry
Registry
OntoSkills uses a simple distribution model:
- the official registry is built in by default
- third-party registries can be added explicitly
- raw source repositories are imported separately and compiled locally
The user-facing CLI is ontoskills.
For a live searchable view of the official registry, use the dedicated marketplace page:
Registry Types
Official Registry
The official registry ships with the product. It does not need registry add-source.
Use it when you want published packages maintained by the OntoSkills project:
npx ontoskills search hellonpx ontoskills install marea.greeting/hellonpx ontoskills enable marea.greeting/helloThird-Party Registries
Third-party registries are opt-in. Add them when another team or community maintains a separate catalog:
ontoskills registry add-source acme https://example.com/index.jsonontoskills registry listThese sources are discoverable by ontoskills search and can be installed like the official registry, but they are not built in.
Raw Source Imports
Raw source repositories contain SKILL.md files and are compiled locally.
ontoskills import-source-repo https://github.com/nextlevelbuilder/ui-ux-pro-max-skillSource imports are cloned into ~/.ontoskills/skills/vendor/ and compiled outputs are written to ~/.ontoskills/ontoskills/vendor/.
Skill Lifecycle
Install
Install compiled packages from a registry:
ontoskills install marea.greeting/helloEnable and Disable
Enable or disable installed skills:
ontoskills enable marea.greeting/helloontoskills disable marea.greeting/helloEnabled skills are the ones exposed to OntoMCP.
Update
Update installed components explicitly:
ontoskills update mcpontoskills update coreontoskills update marea.greeting/helloRebuild Index
Rebuild the local registry state and enabled index:
ontoskills rebuild-indexRemove
Remove a package or skill:
ontoskills remove marea.greeting/helloUninstall Everything
Remove the entire managed user home:
ontoskills uninstall --allThis removes the whole ~/.ontoskills/ tree, including installed binaries, compiled ontologies, locks, caches, and any managed compiler install.
Local Layout
The managed home is organized like this:
~/.ontoskills/ bin/ core/ ontoskills/ skills/ state/bin/stores managed binaries such asontomcpcore/stores the managed compiler install, if presentontoskills/stores compiled ontology artifactsskills/stores imported source repositoriesstate/stores lockfiles, registry configuration, and cache metadata
Practical Rules
install mcpinstalls the runtimeinstall coreinstalls the compilerinstall <qualified-skill-id>installs a compiled package from a registryimport-source-repo <repo>clones and compiles a raw source repositoryenableanddisablecontrol what OntoMCP sees- the official registry is built in, so it should not be added manually