Port Custom Agent Skills & MCPs
to your new agy CLI Natively
A surgical, safe, and zero-dependency Python utility to unify all your agentic capabilities and custom Model Context Protocol configurations in under 0.05 seconds.
100% Automated Backups
Every configuration edit is preceded by a timestamped copy: `settings.json.YYYYMMDD_HHMMSS.bak`. Zero data risk.
Cross-Platform Compliance
POSIX standard symlinking on macOS/Linux. Standard Junctions (`mklink /J`) or safe copy fallback on Windows with zero terminal elevation requirements.
One-Command Rollback
A single CLI flag (`--rollback`) unlinks all ported skills and restores your configuration from the latest active backup.
High-Level Data Flow
1. Scan Profiles
Locates Claude skill directories and `mcp.json` parameters.
2. Compare Diff
Surgically maps missing items against active agy profiles.
3. Create Link
Generates symlinks or directory junctions safely.
4. Merge JSON
Safely updates custom registers in settings.
🤝 Collaboration & Contributions
We welcome all developers, AI engineers, and open-source contributors to help expand the **agy-cli-migrator** ecosystem. Join us to help build a cleaner capability management experience!
1 Submit Pull Requests
Fork the repository, make surgical changes in separated branches, and open a PR for review.
2 Report Issues & Ideas
Use the GitHub issue tracker to report bugs, suggest optimisations, or request custom configurations.
3 Build Custom Skills
Defer to the **`AGENTS.md`** guidelines to properly package and test your custom skills before integration.