migrate-skaile-manifest

Convert legacy skaile.yaml manifests to canonical-identity shape with publisher resolution.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/skaile-ai/ai-assets --skill migrate-skaile-manifest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate-skaile-manifest
Source: https://github.com/skaile-ai/ai-assets/tree/main/skaile-development/skills/migrate-skaile-manifest
Command: npx skills add https://github.com/skaile-ai/ai-assets --skill migrate-skaile-manifest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruamel.yaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Legacy Skaile manifests are hard to translate to the canonical-identity model used by the current system. This skill migrates them safely to ensure consistent identity, source mapping, and dependency references.

Core Features & Use Cases

  • Converts repositories maps to sources entries with optional pins.
  • Transforms ai_resources arrays or objects into sources and top-level dependencies with publisher inference.
  • Rewrites dependency refs to the canonical kind:name@publisher[#pin] form, applying publisher mapping and rebranding @skaile namespace to @skaile-ai as needed.
  • Provides a safe, dry-run preview when desired and preserves unknown keys to maintain compatibility.

Quick Start

Provide the skaile.yaml path and a publisher-map, then run the migration to produce the canonical-identity manifest.

Frequently Asked Questions about migrate-skaile-manifest

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

FAQPage Schema
How do I migrate a legacy skaile.yaml manifest to the canonical-identity format?▼

To migrate a legacy skaile.yaml manifest, provide the file path and a publisher map, then run the conversion to rewrite repositories, ai_resources, and dependencies into canonical sources, pins, and refs with publisher resolution.

What does converting ai_resources to canonical sources involve?▼

Converting ai_resources to canonical sources involves transforming arrays or objects into sources entries and top-level dependencies, inferring the publisher, and rewriting dependency refs to the canonical kind:name@publisher[#pin] form.

Can I preview skaile.yaml migration changes before applying them?▼

Yes, you can preview skaile.yaml migration changes safely by using the dry-run mode, which generates a canonical-identity manifest preview without modifying the original legacy file.

Does the skaile.yaml migration preserve unknown keys in the manifest?▼

Yes, the skaile.yaml migration preserves unknown keys in the manifest to maintain compatibility, ensuring that fields outside repositories, ai_resources, and dependencies remain intact during canonical-identity conversion.

What is the best way to resolve publishers when rewriting dependency refs in YAML manifests?▼

The best way to resolve publishers when rewriting dependency refs is to use a publisher map, which rebrands the @skaile namespace to @skaile-ai as needed and applies canonical kind:name@publisher[#pin] formatting.

Do I need ruamel.yaml to convert legacy manifests to canonical identity?▼

Yes, you need the ruamel.yaml dependency to parse and rewrite legacy manifests, as the conversion process relies on it to safely transform skaile.yaml files into the canonical-identity shape.