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.