odoo-upgrade-skill

🥈Silver

Comprehensive Odoo ERP upgrade skill for Claude Code - Automates migrations between Odoo versions 14-19 with pattern detection and fixes

4630Updated 4mo ago

Intermediate30min to implementautomation

Saves ~120 min per use

Quick InstallView Source

git clone https://github.com/ahmed-lakosha/odoo-upgrade-skill.git

Works with:

Claude

Overview

About This Skill

The odoo-upgrade-skill is a comprehensive migration assistant for Claude Code that automates Odoo ERP upgrades across versions 14 through 19. It handles complex transformations including XML view migrations (tree to list), Python API updates, OWL lifecycle hook changes, controller migrations, and SCSS variable restructuring. The skill includes 150+ upgrade patterns and 75+ automated fixes that detect and resolve common breaking changes across major version jumps. Developers benefit from reduced manual migration work, fewer compatibility errors, and faster time-to-production for upgraded Odoo modules.

How to Use

Install the plugin from the Claude Code marketplace. Run the `/odoo-upgrade` command and provide your module code or file path. The skill analyzes the code, detects version-specific patterns, and applies automated fixes. Review suggested transformations before accepting changes.

Use Cases

Migrate Odoo modules from version 14 to 16, 17, 18, or 19

Automatically fix XML view syntax changes (tree→list, attrs→inline)

Update Python code for OWL 1.x to 2.0 lifecycle hook changes

Transform controller types and RPC service calls for new versions

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/ahmed-lakosha/odoo-upgrade-skill

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I need to upgrade my Odoo ERP system from version [CURRENT_VERSION] to version [TARGET_VERSION]. The system is used by [COMPANY] in the [INDUSTRY] sector. Here are some key modules I rely on: [MODULES]. Please provide a step-by-step upgrade plan, including any potential issues and their solutions.

Example Output

# Odoo Upgrade Plan: Version 15 to 19

## Step 1: Pre-Upgrade Assessment
- **Current Version**: Odoo 15
- **Target Version**: Odoo 19
- **Key Modules**: Inventory, Sales, Accounting
- **Custom Modules**: 3 (Inventory Custom, Sales Custom, Reporting Custom)

## Step 2: Backup and Environment Setup
- **Backup**: Full database and file system backup completed.
- **Staging Environment**: Created a staging environment mirroring production.

## Step 3: Module Compatibility Check
- **Inventory Module**: Compatible with Odoo 19, no issues detected.
- **Sales Module**: Requires minor adjustments due to API changes.
- **Accounting Module**: Fully compatible.
- **Custom Modules**: Require updates to align with Odoo 19's framework.

## Step 4: Upgrade Process
- **Database Upgrade**: Successfully upgraded from PostgreSQL 12 to 15.
- **Code Upgrade**: Updated custom modules to be compatible with Odoo 19.
- **Data Migration**: Migrated all data without loss or corruption.

## Step 5: Testing and Validation
- **Functional Testing**: All core functionalities tested and verified.
- **Performance Testing**: System performance meets expected benchmarks.
- **User Acceptance Testing**: End-users have approved the upgraded system.

## Step 6: Deployment Plan
- **Deployment Window**: Scheduled for [DATE] during off-peak hours.
- **Rollback Plan**: In place in case of any issues.
- **Post-Upgrade Support**: 24/7 support for the first week post-upgrade.

## Potential Issues and Solutions
- **Issue**: API changes in Sales Module
- **Solution**: Updated custom code to align with new APIs.
- **Issue**: Data migration errors
- **Solution**: Implemented data validation scripts to ensure accuracy.

## Conclusion
The upgrade from Odoo 15 to 19 has been successfully planned and executed. The system is now ready for deployment to the production environment.