Can I preview the migration before it happens?

Yes, by using the dry_run parameter, you can view a detailed diff of the planned changes without actually modifying your files.

What happens if the migration fails validation?

The skill includes a safety stop; if the newly generated configuration fails JSON syntax or schema validation, it will automatically restore the backup and report the error.

Is it safe to migrate my configuration files using this skill?

Yes, the skill automatically creates a timestamped backup of your existing configuration before any changes are made, allowing for an immediate rollback if needed.

Does this migration delete my old settings?

No, the migrator is designed to preserve critical fields such as organization, repository, and version settings while converting legacy patterns into the new structure.

Which formats are supported by the Config Migrator?

It specifically migrates configurations from the v2.0 push-based sync (SPEC-00012) to the v3.0 pull-based retrieval format (SPEC-00030).

Config Migrator

Name: Config Migrator
Author: fractary

$fractary$ byfractary

•

部署与 DevOps

Migrates Codex configuration files from legacy push-based sync to the modern pull-based retrieval format with automated safety checks.

The Config Migrator skill simplifies the transition for Fractary Codex users moving from legacy v2.0 (SPEC-00012) push-based synchronization to the improved v3.0 (SPEC-00030) pull-based retrieval architecture. It handles the complex mapping of organization settings and repository patterns to the new format while prioritizing data integrity through mandatory backups and strict JSON validation. This skill is essential for developers upgrading their Codex environment who want to ensure a seamless transition without manual configuration errors or data loss.

主要功能

01Mandatory timestamped backups created automatically before any file modification

02Preservation of existing organization, repository, and version metadata

03Strict validation engine to verify configuration integrity before finalization

04Dry-run capability to preview configuration diffs without applying changes

05Automated migration from SPEC-00012 push-based to SPEC-00030 pull-based formats

062 GitHub stars

使用场景

01Auditing legacy sync patterns and converting them to modern permission guidance

02Upgrading local Codex plugin environments to support modern retrieval workflows

03Standardizing configuration files across team repositories during version transitions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins config-migrator

For use in Claude.ai and ChatGPT

Download Skill