kairos-hub-migration

Migrate ontology hub repositories from flat to grouped directory layouts.

1|1|Updated Jan 3, 2026

Search Tags:#ontology #migration #refactor #toolkit #git-workflow #directory-structure #hub-migration

Ready to run

npx skills add https://github.com/Cnext-eu/kairos-ontology-toolkit --skill kairos-hub-migration

💬 Prompt for ChatGPT / Claude Chat▼

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.