A collection of intelligent agents and automation skills for the os-migrate Ansible collection, designed to streamline parallel cloud migrations and provide AI-powered assistance throughout the migration lifecycle.
This repository provides Claude Code skills and AI agents that automate and enhance various aspects of cloud migration workflows. From development and release automation to customer-facing diagnostic tools, these skills help teams migrate workloads more efficiently and reliably.
Skills that automate the development lifecycle for os-migrate:
- Release Automation - Automated release processes for os-migrate components
- Linting & Quality - Code quality checks for Golang, Ansible, and Python
- CI/CD Debugging - Intelligent analysis of CI pipeline failures
- Dependency Management - Automated dependency updates and conflict resolution
Customer-facing skills for migration execution and troubleshooting:
- Migration Log Analysis - AI-powered investigation of migration failures and errors
- virt-inspector Integration - Pre-migration guest inspection and compatibility checks
- Performance Analysis - Migration throughput optimization and bottleneck detection
- Rollback Assistance - Guided rollback procedures when migrations encounter issues
Deep diagnostic capabilities for complex migration scenarios:
- Resource Mapping - Automated discovery and mapping of source to target resources
- Network Validation - Pre and post-migration network connectivity verification
- State Reconciliation - Compare expected vs actual state after migration
- Error Pattern Recognition - Learn from historical failures to predict and prevent issues
- Claude Code CLI or desktop app
- Access to the os-migrate Ansible collection
- Appropriate cloud credentials for your migration scenario
Clone this repository to your local environment:
git clone https://github.com/os-migrate/migration-skills.git
cd migration-skillsLoad skills into your Claude Code session:
# Skills are automatically discovered from the skills/ directory
claudeSkills can be invoked directly within Claude Code conversations:
# Example: Analyze migration logs
/migration-log-analysis --log-path /var/log/os-migrate/latest.log
# Example: Run pre-migration inspection
/virt-inspector --vm vm-name-123 --platform vmware
# Example: Debug CI failure
/ci-debug --build-id 12345 --pipeline release
migration-skills/
├── skills/
│ ├── release/ # Release automation skills
│ ├── linting/ # Code quality and linting
│ ├── ci-debug/ # CI/CD troubleshooting
│ ├── migration-logs/ # Log analysis and debugging
│ ├── virt-inspector/ # Guest inspection tools
│ └── diagnostics/ # General diagnostic utilities
├── agents/ # Standalone AI agents
└── tests/ # Skill test suites
- Create a new directory under
skills/with your skill name - Add a
skill.mdfile with skill definition and prompts - Include any supporting scripts or resources
- Add tests to validate skill behavior
- Update this README with skill documentation
Example skill structure:
skills/my-new-skill/
├── skill.md # Skill definition
├── prompts/ # Reusable prompt templates
├── scripts/ # Helper scripts
└── tests/ # Skill tests
Contributions are welcome! Whether you're fixing bugs, adding new skills, or improving documentation:
- Fork this repository
- Create a feature branch (
git checkout -b feature/amazing-skill) - Commit your changes (
git commit -m 'Add amazing migration skill') - Push to the branch (
git push origin feature/amazing-skill) - Open a Pull Request
- Skills should be well-documented with clear use cases
- Include examples and expected outputs
- Add tests for new functionality
- Follow existing naming conventions
- Keep skills focused and composable
- Quickly diagnose migration failures without manual log parsing
- Validate guest compatibility before initiating migrations
- Optimize migration parameters based on workload characteristics
- Automate release processes with confidence
- Catch issues early with intelligent linting
- Debug CI failures faster with contextual analysis
- Build migration playbooks with AI assistance
- Create custom migration workflows
- Monitor and optimize large-scale parallel migrations
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
- os-migrate - Parallel cloud migration toolkit
- Claude Code - AI pair programmer and automation platform
For questions, issues, or feature requests:
- Open an issue in this repository
- Join the os-migrate community discussions
- Consult the os-migrate documentation