Enterprise-grade GitHub Copilot agents that automatically migrate CI/CD pipelines from virtually any platform to GitHub Actions—powered by a comprehensive knowledgebase of migration patterns and best practices.
Organizations migrating to GitHub Actions face:
- Inconsistent migrations across teams
- Loss of domain knowledge during manual conversions
- Security oversights with credentials
- Time-consuming manual work
- Lack of validation leading to broken workflows
This project delivers:
- ⚡ Faster than manual migration
- 🎯 Consistent quality using documented best practices
- ✅ Built-in validation with actionlint
- 📊 Complete documentation of every decision
- 🔄 Reusable patterns for future migrations
| Agent | Migrates From | Handles |
|---|---|---|
| Jenkins Migrator | Jenkinsfile | Pipelines, shared libraries, Groovy scripts |
| Azure DevOps Migrator | azure-pipelines.yml | YAML pipelines, templates, variable groups |
| CircleCI Migrator | .circleci/config.yml | Workflows, jobs, Orbs |
| GitLab Migrator | .gitlab-ci.yml | Pipelines, includes, Pages |
| Travis CI Migrator | .travis.yml | Build matrix, deploy providers |
| Bamboo Migrator | bamboo-specs.yml | Build plans, deployment projects |
| Bitbucket Migrator | bitbucket-pipelines.yml | Pipelines, Pipes |
| Drone CI Migrator | .drone.yml | Pipelines, plugins |
| Reusable Workflow Builder | GitHub Actions across orgs | Pattern analysis, reusable workflows |
The Reusable Workflow Builder scans multiple GitHub organizations, detects common CI/CD patterns (Node.js builds, AWS deployments, Docker workflows), and generates standardized reusable workflows—reducing duplication and capturing organizational best practices.
This project ships the same agents for two GitHub Copilot surfaces. Pick the one that matches how your team works.
| Surface | Best For | How agents are delivered |
|---|---|---|
| 🌐 Copilot cloud agent | Org-wide rollout, batch migrations across many repos, central governance | Deployed to your enterprise's .github-private repository. Agents fetch the knowledgebase from knowledge/ at runtime via the GitHub MCP server. → Jump to setup |
| 💻 Copilot CLI | Local/interactive use, individual developers, customizing skills for your org | Installed as a Copilot CLI plugin. The knowledgebase ships pre-split into composable skills under plugin/—no runtime fetch required. → Jump to setup |
Both surfaces produce the same deliverables:
.github/workflows/*.yml— production-ready, validated workflows.github/ci-archive/— original files andMIGRATION-README.mdpreserved for reference- Pull Request — migration report in the PR body with validation results, required secrets, next steps, and knowledgebase references
Agents live in agents/ and reference the knowledgebase in knowledge/ at runtime. They are deployed to your enterprise's .github-private repository so they're available to all internal repos.
- Deploy — Follow the Deployment Guide to set up the agents in your enterprise's
.github-privaterepo. - Migrate — Run migrations using the Operations Guide.
| Method | Best For | Guide |
|---|---|---|
| Manual | Individual repos, testing | Operations Guide |
| Batch | Multiple repos, scale | Operations Guide |
The same nine agents are packaged as a Copilot CLI plugin under plugin/, with the knowledgebase pre-split into composable skills. See plugin/README.md for the composition model and full skill catalog.
Fastest path. Use this when you want the agents with the default knowledgebase.
copilot plugin marketplace add github/actions-migrations-via-copilot
copilot plugin install actions-migratorThe marketplace is defined in .github/plugin/marketplace.json.
Use this when you want to tailor patterns, action mappings, security guardrails, or report templates to your organization.
git clone https://github.com/github/actions-migrations-via-copilot.git
cd actions-migrations-via-copilot
# edit files under plugin/skills/ to match your org's standards
copilot plugin install ./pluginWhichever surface you choose, each agent follows the same five-phase process:
- Reads source CI/CD configuration files
- References the knowledgebase for conversion patterns
- Generates GitHub Actions workflows
- Validates with actionlint
- Documents all changes in a migration report
| Guide | Purpose |
|---|---|
| Deployment Guide | Set up agents in your enterprise (cloud agent) |
| Operations Guide | Use agents to migrate repositories |
| Extending Guide | Add new CI/CD platforms |
| Plugin README | Copilot CLI plugin details |
| Contributing Guide | Contribute improvements |
.
├── agents/ # Agent definitions (9 migration agents) — cloud agent / .github-private deployment
├── docs/ # Deployment, operations, and extending guides
├── knowledge/ # Migration knowledgebase (source of truth for cloud agent)
│ ├── actions-mapping/ # CI/CD → Actions mappings
│ ├── patterns/ # Platform-specific conversion patterns
│ └── report-template/ # Migration report templates
├── plugin/ # Copilot CLI plugin (agents + composable skills, derived from knowledge/)
│ ├── plugin.json
│ ├── agents/ # 9 thin agent composers
│ └── skills/ # 11 skills (3 core + 8 platform)
└── .github/
└── plugin/
└── marketplace.json # Copilot CLI plugin marketplace manifest
Detailed structure: See Extending Guide for complete file organization.
We welcome contributions! See our guides:
- CONTRIBUTING.md — General contribution guidelines
- Extending Guide — Add new CI/CD platforms or improve agents
Ways to contribute:
- Add support for new CI/CD platforms
- Improve action mappings and patterns
- Enhance agent accuracy
- Report issues or suggest improvements
- Documentation — Deployment | Operations | Extending | Plugin
- Discussions — Ask questions and share experiences
- Issues — Report bugs or request features
- GitHub Actions Docs — Official documentation
Built by GitHub Professional Services for enterprise CI/CD migration programs. Contributions from GitHub's field engineering, solutions architecture, and customer success teams.