{"id":"bef06e4c-b608-4338-b78a-61b8a4b58c9c","shortId":"4PwNpZ","kind":"skill","title":"magento-upgrade-specialist","tagline":"Manages seamless Magento 2 version upgrades and migrations. Use when upgrading Magento versions, migrating from Magento 1, planning upgrade strategies, assessing compatibility, or handling breaking changes. Masters upgrade planning, compatibility assessment, and post-upgrade opti","description":"# Magento 2 Upgrade Specialist\n\nExpert specialist in ensuring smooth, risk-free transitions between Magento versions while maintaining business continuity and preserving custom functionality.\n\n## When to Use\n\n- Upgrading Magento 2 versions (minor or major)\n- Migrating from Magento 1.x to Magento 2.x\n- Planning upgrade strategies and timelines\n- Assessing extension compatibility\n- Handling breaking changes\n- Post-upgrade optimization\n\n## Upgrade Process Framework\n\n### 1. Pre-Upgrade Assessment\n- **Current System Audit**: Comprehensive analysis of existing Magento installation\n- **Custom Code Review**: Evaluate all custom modules, themes, and modifications\n- **Extension Compatibility**: Check third-party extension compatibility with target version\n- **Data Integrity Check**: Verify database consistency and identify potential issues\n- **Performance Baseline**: Establish current performance metrics for comparison\n\n### 2. Compatibility Analysis\n- **Static Code Analysis**: Use automated tools to identify compatibility issues\n- **API Change Review**: Analyze breaking changes in core APIs and interfaces\n- **Deprecated Feature Assessment**: Identify and plan replacement for deprecated functionality\n- **Database Schema Changes**: Review required database modifications\n- **Configuration Changes**: Identify system configuration updates needed\n\n### 3. Migration Planning\n- **Upgrade Path Strategy**: Choose optimal upgrade path (direct vs. incremental)\n- **Environment Setup**: Plan development, staging, and production upgrade environments\n- **Downtime Minimization**: Develop strategies to reduce production downtime\n- **Data Migration Strategy**: Plan for large dataset migrations and optimizations\n- **Contingency Planning**: Prepare for various failure scenarios and recovery procedures\n\n### 4. Implementation Execution\n- **Code Migration**: Update custom code to work with target Magento version\n- **Database Upgrade**: Execute database schema and data migrations\n- **Configuration Migration**: Transfer and update system configurations\n- **Extension Updates**: Upgrade or replace third-party extensions\n- **Testing Validation**: Comprehensive testing of all upgraded functionality\n\n## Upgrade Categories\n\n### Minor Version Upgrades (2.4.x to 2.4.y)\n- **Security Patches**: Apply critical security updates\n- **Bug Fixes**: Resolve known issues and stability improvements\n- **Feature Enhancements**: Leverage minor feature additions\n- **Compatibility Updates**: Maintain extension and custom code compatibility\n- **Performance Improvements**: Benefit from performance optimizations\n\n### Major Version Upgrades (2.3.x to 2.4.x)\n- **PHP Version Updates**: Handle PHP version compatibility requirements\n- **Composer Dependencies**: Update package dependencies and constraints\n- **API Changes**: Adapt to breaking changes in core APIs\n- **New Architecture**: Leverage new architectural improvements\n- **Migration Tools**: Utilize official migration utilities and scripts\n\n### Legacy Migrations (Magento 1.x to 2.x)\n- **Data Migration**: Comprehensive data structure transformation\n- **Theme Migration**: Complete frontend redesign and implementation\n- **Extension Replacement**: Find and implement Magento 2 equivalents\n- **Custom Code Rewrite**: Rebuild custom functionality for Magento 2\n- **Training Requirements**: Team training on Magento 2 architecture\n\n## Upgrade Commands\n\n### Pre-Upgrade\n```bash\n# Check current version\nbin/magento --version\n\n# Check database status\nbin/magento setup:db:status\n\n# Backup database\nmysqldump -u user -p database > backup.sql\n\n# Check extension compatibility\ncomposer show | grep magento\n```\n\n### During Upgrade\n```bash\n# Update composer dependencies\ncomposer require magento/product-community-edition:2.4.x --no-update\ncomposer update\n\n# Run upgrade\nbin/magento setup:upgrade\nbin/magento setup:di:compile\nbin/magento setup:static-content:deploy -f\nbin/magento cache:flush\nbin/magento indexer:reindex\n```\n\n### Post-Upgrade\n```bash\n# Verify installation\nbin/magento setup:db:status\nbin/magento setup:upgrade\n\n# Test functionality\n# Run automated tests\n# Manual testing checklist\n```\n\n## Common Upgrade Challenges\n\n### Breaking Changes\n- **API Changes**: Update code using deprecated APIs\n- **Class Changes**: Update class references and namespaces\n- **Configuration Changes**: Update XML configuration files\n- **Database Schema**: Handle schema changes and migrations\n- **Frontend Changes**: Update templates and layouts\n\n### Extension Compatibility\n- **Version Conflicts**: Resolve composer dependency conflicts\n- **API Compatibility**: Update extensions using deprecated APIs\n- **Replacement Extensions**: Find Magento 2 equivalents for incompatible extensions\n- **Custom Patches**: Create patches for minor compatibility issues\n\n### Data Migration\n- **Schema Changes**: Handle database structure changes\n- **Data Transformation**: Transform data to new formats\n- **Custom Attributes**: Migrate custom EAV attributes\n- **Media Files**: Migrate images and media files\n\n## Best Practices\n\n### Planning\n- **Timeline Planning**: Create realistic upgrade schedules with proper testing phases\n- **Risk Analysis**: Identify potential breaking changes and their business impact\n- **Resource Planning**: Estimate effort, downtime, and team requirements\n- **Rollback Strategy**: Plan comprehensive rollback procedures\n\n### Execution\n- **Environment Testing**: Test thoroughly in development and staging\n- **Incremental Approach**: Consider incremental upgrades for major version changes\n- **Documentation**: Document all changes and customizations\n- **Communication**: Keep stakeholders informed throughout the process\n\n### Post-Upgrade\n- **Performance Validation**: Ensure performance meets or exceeds baseline\n- **Functionality Testing**: Comprehensive testing of all features\n- **Security Review**: Verify security improvements are properly implemented\n- **Monitoring**: Monitor system health and performance post-upgrade\n\n## Testing Strategy\n\n- **Unit Tests**: Run and update unit tests\n- **Integration Tests**: Test module integration with core\n- **Functional Tests**: End-to-end test scenarios\n- **Performance Tests**: Validate performance under load\n- **Security Tests**: Verify security compliance\n\n## References\n\n- [Adobe Commerce Upgrade Guide](https://developer.adobe.com/commerce/operate/upgrade/)\n- [Release Notes](https://devdocs.magento.com/guides/v2.4/release-notes/)\n- [Migration Guide](https://developer.adobe.com/commerce/php/development/migration/)\n\nFocus on smooth, risk-free upgrades that maintain business continuity while leveraging new Magento capabilities.","tags":["magento","upgrade","specialist","magento2","agent","skills","maxnorm","agent-skills"],"capabilities":["skill","source-maxnorm","skill-magento-upgrade-specialist","topic-agent-skills","topic-magento2"],"categories":["magento2-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/maxnorm/magento2-agent-skills/magento-upgrade-specialist","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add maxnorm/magento2-agent-skills","source_repo":"https://github.com/maxnorm/magento2-agent-skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 9 github stars · SKILL.md body (6,623 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:08:50.752Z","embedding":null,"createdAt":"2026-05-07T20:44:31.085Z","updatedAt":"2026-05-18T19:08:50.752Z","lastSeenAt":"2026-05-18T19:08:50.752Z","tsv":"'/commerce/operate/upgrade/)':770 '/commerce/php/development/migration/)':780 '/guides/v2.4/release-notes/)':775 '1':21,78,102,392 '2':8,42,70,82,155,395,416,426,433,584 '2.3':346 '2.4':304,307,349,477 '3':203 '4':253 'adapt':368 'addit':328 'adob':764 'analysi':111,157,160,639 'analyz':171 'api':168,176,366,374,532,538,573,579 'appli':311 'approach':672 'architectur':376,379,434 'assess':25,35,89,106,181 'attribut':613,617 'audit':109 'autom':162,522 'backup':453 'backup.sql':460 'baselin':148,703 'bash':440,470,509 'benefit':339 'best':625 'bin/magento':444,449,486,489,493,500,503,512,516 'break':29,93,172,370,530,642 'bug':315 'busi':59,646,790 'cach':501 'capabl':796 'categori':300 'challeng':529 'chang':30,94,169,173,191,197,367,371,531,533,540,547,556,560,600,604,643,679,683 'check':128,139,441,446,461 'checklist':526 'choos':209 'class':539,542 'code':117,159,256,260,335,419,535 'command':436 'commerc':765 'common':527 'communic':686 'comparison':154 'compat':26,34,91,127,133,156,166,329,336,357,463,566,574,595 'compil':492 'complet':405 'complianc':762 'compos':359,464,472,474,482,570 'comprehens':110,293,399,659,706 'configur':196,200,275,281,546,550 'conflict':568,572 'consid':673 'consist':142 'constraint':365 'content':497 'conting':243 'continu':60,791 'core':175,373,743 'creat':591,630 'critic':312 'current':107,150,442 'custom':63,116,121,259,334,418,422,589,612,615,685 'data':137,233,273,397,400,597,605,608 'databas':141,189,194,267,270,447,454,459,552,602 'dataset':239 'db':451,514 'depend':360,363,473,571 'deploy':498 'deprec':179,187,537,578 'devdocs.magento.com':774 'devdocs.magento.com/guides/v2.4/release-notes/)':773 'develop':219,227,668 'developer.adobe.com':769,779 'developer.adobe.com/commerce/operate/upgrade/)':768 'developer.adobe.com/commerce/php/development/migration/)':778 'di':491 'direct':213 'document':680,681 'downtim':225,232,652 'eav':616 'effort':651 'end':747,749 'end-to-end':746 'enhanc':324 'ensur':48,698 'environ':216,224,663 'equival':417,585 'establish':149 'estim':650 'evalu':119 'exceed':702 'execut':255,269,662 'exist':113 'expert':45 'extens':90,126,132,282,290,332,410,462,565,576,581,588 'f':499 'failur':248 'featur':180,323,327,710 'file':551,619,624 'find':412,582 'fix':316 'flush':502 'focus':781 'format':611 'framework':101 'free':52,786 'frontend':406,559 'function':64,188,298,423,520,704,744 'grep':466 'guid':767,777 'handl':28,92,354,554,601 'health':722 'identifi':144,165,182,198,640 'imag':621 'impact':647 'implement':254,409,414,718 'improv':322,338,380,715 'incompat':587 'increment':215,671,674 'index':504 'inform':689 'instal':115,511 'integr':138,737,741 'interfac':178 'issu':146,167,319,596 'keep':687 'known':318 'larg':238 'layout':564 'legaci':389 'leverag':325,377,793 'load':757 'magento':2,7,16,20,41,55,69,77,81,114,265,391,415,425,432,467,583,795 'magento-upgrade-specialist':1 'magento/product-community-edition':476 'maintain':58,331,789 'major':74,343,677 'manag':5 'manual':524 'master':31 'media':618,623 'meet':700 'metric':152 'migrat':12,18,75,204,234,240,257,274,276,381,385,390,398,404,558,598,614,620,776 'minim':226 'minor':72,301,326,594 'modif':125,195 'modul':122,740 'monitor':719,720 'mysqldump':455 'namespac':545 'need':202 'new':375,378,610,794 'no-upd':479 'note':772 'offici':384 'opti':40 'optim':98,210,242,342 'p':458 'packag':362 'parti':131,289 'patch':310,590,592 'path':207,212 'perform':147,151,337,341,696,699,724,752,755 'phase':637 'php':351,355 'plan':22,33,84,184,205,218,236,244,627,629,649,658 'post':38,96,507,694,726 'post-upgrad':37,95,506,693,725 'potenti':145,641 'practic':626 'pre':104,438 'pre-upgrad':103,437 'prepar':245 'preserv':62 'procedur':252,661 'process':100,692 'product':222,231 'proper':635,717 'realist':631 'rebuild':421 'recoveri':251 'redesign':407 'reduc':230 'refer':543,763 'reindex':505 'releas':771 'replac':185,286,411,580 'requir':193,358,428,475,655 'resolv':317,569 'resourc':648 'review':118,170,192,712 'rewrit':420 'risk':51,638,785 'risk-fre':50,784 'rollback':656,660 'run':484,521,732 'scenario':249,751 'schedul':633 'schema':190,271,553,555,599 'script':388 'seamless':6 'secur':309,313,711,714,758,761 'setup':217,450,487,490,494,513,517 'show':465 'skill' 'skill-magento-upgrade-specialist' 'smooth':49,783 'source-maxnorm' 'specialist':4,44,46 'stabil':321 'stage':220,670 'stakehold':688 'static':158,496 'static-cont':495 'status':448,452,515 'strategi':24,86,208,228,235,657,729 'structur':401,603 'system':108,199,280,721 'target':135,264 'team':429,654 'templat':562 'test':291,294,519,523,525,636,664,665,705,707,728,731,736,738,739,745,750,753,759 'theme':123,403 'third':130,288 'third-parti':129,287 'thorough':666 'throughout':690 'timelin':88,628 'tool':163,382 'topic-agent-skills' 'topic-magento2' 'train':427,430 'transfer':277 'transform':402,606,607 'transit':53 'u':456 'unit':730,735 'updat':201,258,279,283,314,330,353,361,471,481,483,534,541,548,561,575,734 'upgrad':3,10,15,23,32,39,43,68,85,97,99,105,206,211,223,268,284,297,299,303,345,435,439,469,485,488,508,518,528,632,675,695,727,766,787 'use':13,67,161,536,577 'user':457 'util':383,386 'valid':292,697,754 'various':247 'verifi':140,510,713,760 'version':9,17,56,71,136,266,302,344,352,356,443,445,567,678 'vs':214 'work':262 'x':79,83,305,347,350,393,396,478 'xml':549 'y':308","prices":[{"id":"c53a539f-cafa-45ed-93df-842c06a86d0a","listingId":"bef06e4c-b608-4338-b78a-61b8a4b58c9c","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"maxnorm","category":"magento2-agent-skills","install_from":"skills.sh"},"createdAt":"2026-05-07T20:44:31.085Z"}],"sources":[{"listingId":"bef06e4c-b608-4338-b78a-61b8a4b58c9c","source":"github","sourceId":"maxnorm/magento2-agent-skills/magento-upgrade-specialist","sourceUrl":"https://github.com/maxnorm/magento2-agent-skills/tree/main/skills/magento-upgrade-specialist","isPrimary":false,"firstSeenAt":"2026-05-18T13:14:30.032Z","lastSeenAt":"2026-05-18T19:08:50.752Z"},{"listingId":"bef06e4c-b608-4338-b78a-61b8a4b58c9c","source":"skills_sh","sourceId":"maxnorm/magento2-agent-skills/magento-upgrade-specialist","sourceUrl":"https://skills.sh/maxnorm/magento2-agent-skills/magento-upgrade-specialist","isPrimary":true,"firstSeenAt":"2026-05-07T20:44:31.085Z","lastSeenAt":"2026-05-07T22:42:50.046Z"}],"details":{"listingId":"bef06e4c-b608-4338-b78a-61b8a4b58c9c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"maxnorm","slug":"magento-upgrade-specialist","github":{"repo":"maxnorm/magento2-agent-skills","stars":9,"topics":["agent-skills","magento2"],"license":"mit","html_url":"https://github.com/maxnorm/magento2-agent-skills","pushed_at":"2026-01-24T16:45:35Z","description":"A collection of specialized agent skills for Magento 2 development, designed to provide domain expertise across all aspects of Magento/Adobe Commerce development workflows. ","skill_md_sha":"e6bb615cf694094cdbe2384db9bf81472fcae833","skill_md_path":"skills/magento-upgrade-specialist/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/maxnorm/magento2-agent-skills/tree/main/skills/magento-upgrade-specialist"},"layout":"multi","source":"github","category":"magento2-agent-skills","frontmatter":{"name":"magento-upgrade-specialist","description":"Manages seamless Magento 2 version upgrades and migrations. Use when upgrading Magento versions, migrating from Magento 1, planning upgrade strategies, assessing compatibility, or handling breaking changes. Masters upgrade planning, compatibility assessment, and post-upgrade optimization."},"skills_sh_url":"https://skills.sh/maxnorm/magento2-agent-skills/magento-upgrade-specialist"},"updatedAt":"2026-05-18T19:08:50.752Z"}}