kairos-hub-migration

Migrate ontology hub repositories from flat to grouped directory layouts.

1|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/Cnext-eu/kairos-ontology-toolkit --skill kairos-hub-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kairos-hub-migration
Source: https://github.com/Cnext-eu/kairos-ontology-toolkit/tree/main/.github/skills/kairos-hub-migration
Command: npx skills add https://github.com/Cnext-eu/kairos-ontology-toolkit --skill kairos-hub-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates an existing ontology hub repository from the flat directory layout to the new grouped model/integration/output structure, simplifying maintenance and deployment.

Core Features & Use Cases

  • Preview the migration with kairos-ontology migrate --check to see what changes would occur.
  • Execute the migration with kairos-ontology migrate to move files into the new structure and then refresh managed files with kairos-ontology update.
  • Validate and re-project outputs to ensure consistency and traceability after restructuring.

Quick Start

Run the migrate workflow to begin upgrading your hub to the grouped layout.

Frequently Asked Questions about kairos-hub-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate an ontology hub from a flat directory layout to a grouped structure?

To migrate an ontology hub, use the kairos-ontology migrate command to move files from the flat ontology-hub/ontologies directory into the grouped model/, integration/, and output/ directories.

What do I need to prepare before migrating my ontology hub repository?

Before migrating your ontology hub, you must upgrade your toolkit to a version containing the migrate command, ensure a clean git working tree, and establish a feature-branch workflow to safely perform the changes.

Can I preview ontology hub directory changes before executing the migration?

Yes, you can preview the ontology hub migration by running kairos-ontology migrate --check to see exactly what file moves would occur before applying any structural changes to your repository.

Why does my ontology hub repository use a flat directory layout and need refactoring?

Ontology hub repositories created with toolkit v2.4.x or earlier use a flat directory layout that complicates maintenance and deployment, requiring refactoring into a grouped model, integration, and output structure.

How do I validate outputs after restructuring my ontology hub directory?

After restructuring your ontology hub, validate and re-project outputs to ensure consistency and traceability, then run kairos-ontology update to refresh all managed files within the new grouped structure.