config-migrations

Migrate operator config schemas across versions with validation and deprecation warnings.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/cyberpunk042/devops-expert-local-ai --skill config-migrations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: config-migrations
Source: https://github.com/cyberpunk042/devops-expert-local-ai/tree/main/.claude/skills/config-migrations
Command: npx skills add https://github.com/cyberpunk042/devops-expert-local-ai --skill config-migrations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Config migrations automate the evolution of AICP's operator config schema across versions, handling key renames, shape changes, deprecations, and new required keys to keep deployments consistent.

Core Features & Use Cases

  • Plan and enact schema changes (rename, restructure, deprecate, and add required keys) with safety checks.
  • Migrate in-place across all config layers (default.yaml, profiles/*.yaml, ~/.aicp/config.yaml, <project>/.aicp/config.yaml) and validate post-migration.
  • Provide documentation and tooling guidance to ensure operators can verify and complete migrations.

Quick Start

Run the migration workflow to upgrade all operator configs to the new schema.

Frequently Asked Questions about config-migrations

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

FAQPage Schema
How do I migrate operator config schemas across versions in AICP?

To migrate operator config schemas, run the migration workflow to upgrade all AICP configs to the new schema. It handles key renames, shape changes, deprecations, and new required keys across all config layers.

Which config files are covered by the AICP config migration process?

The AICP config migration process covers default.yaml, profiles/*.yaml, ~/.aicp/config.yaml, and <project>/.aicp/config.yaml. It plans, executes, and validates schema changes across all these deployment layers.

How does validation work during a YAML config schema evolution?

YAML config schema evolution uses in-loader validation and post-migration validation to ensure safe schema changes. It enforces safety checks and provides deprecation warnings to operators during the migration.

Can I migrate AICP configs in-place without breaking existing deployments?

Yes, you can migrate AICP configs in-place without breaking deployments. The migration workflow applies deprecation warnings, enforces in-loader validation, and validates post-migration to keep deployments consistent.

What is the best way to handle deprecated keys and shape changes in AICP configs?

The best way to handle deprecated keys and shape changes is using the dedicated AICP migration utility. It automates schema restructuring with safety checks, deprecation warnings, and post-migration validation across all config files.

Why do I need a dedicated migration utility for AICP config schema changes?

You need a dedicated migration utility for AICP config schema changes to automate key renames, restructure shapes, and add required keys safely. It enforces validation and provides tooling guidance to verify and complete migrations.