Odoo Upgrade Skill for Claude Code

A comprehensive Claude Code skill for automating Odoo ERP module upgrades between versions 14-19, with special focus on the breaking changes in Odoo 19.

🚀 Features

• Automated Pattern Detection: Identifies and fixes common migration issues
• Multi-Version Support: Handles migrations from Odoo 14 through 19
• RPC Service Migration: Automatically converts frontend RPC calls for Odoo 19
• XML Transformation: Fixes view definitions, kanban templates, and search views
• Python API Updates: Handles import changes and deprecated methods
• Theme Migration: Updates SCSS variables and font configurations
• Comprehensive Error Catalog: Documents 25+ common errors with solutions
• Helper Scripts: Python scripts for batch processing

📦 Installation

As a Claude Code Skill

1. Copy the skill to your Claude Code skills directory:

# For project-specific use
cp -r C:\tmp\plugins\odoo-upgrade-skill .claude\skills\

# For global use
cp -r C:\tmp\plugins\odoo-upgrade-skill %USERPROFILE%\.claude\skills\

1. The skill will be automatically available when you ask Claude to upgrade Odoo modules.

As a Standalone Tool

1. Clone or copy the repository:

git clone <repository-url> odoo-upgrade-skill
cd odoo-upgrade-skill

1. Install Python dependencies:

pip install lxml

🎯 Quick Start

Using with Claude Code

Simply ask Claude:

• "Upgrade my Odoo module from version 17 to 19"
• "Fix RPC service errors in my Odoo 19 module"
• "Migrate my theme to Odoo 19"

Claude will automatically use this skill when detecting Odoo upgrade tasks.

Using Helper Scripts Standalone

Fix RPC Service Issues

python scripts/fix_rpc_service.py path/to/module

Update Manifests

python scripts/upgrade_manifest.py path/to/module --target 19

Process Entire Project

python scripts/upgrade_manifest.py path/to/project --recursive --target 19
python scripts/fix_rpc_service.py path/to/project

📋 What Gets Fixed

JavaScript/Frontend (Odoo 19)

• ✅ RPC service removal and replacement with fetch
• ✅ Module annotations (/** @odoo-module **/)
• ✅ Service registration changes
• ✅ Import path updates

XML Views

• ✅ <tree> → <list> conversion
• ✅ Remove edit="1" attributes
• ✅ Fix search view <group> tags
• ✅ Replace active_id with id
• ✅ Kanban template name changes (kanban-box → card)
• ✅ Remove js_class attributes
• ✅ Remove numbercall from cron jobs

Python Code

• ✅ slug function compatibility
• ✅ url_for import changes
• ✅ External dependency declarations
• ✅ API decorator updates

Themes/SCSS

• ✅ Variable naming conventions
• ✅ Font configuration with map-merge
• ✅ Color palette menu/footer assignments
• ✅ Unit conversions (px → rem)

Manifests

• ✅ Version format (e.g., 19.0.1.0.0)
• ✅ Missing license key
• ✅ External dependencies
• ✅ Auto-detect Python packages

🔍 Example: Relief Center Migration

This skill was developed while migrating a complex humanitarian aid system from Odoo 17 to 19:

Project Stats:

• 5 interdependent modules
• 115 files analyzed
• 32 files modified
• 450+ lines changed
• 10 RPC calls migrated
• 7 JavaScript components fixed

Key Issues Resolved:

1. Frontend RPC service unavailable
2. Kanban views broken
3. Search filters not working
4. Theme colors not applying
5. MapTiler integration failing

📚 Documentation Structure

odoo-upgrade-skill/
├── SKILL.md                    # Main skill definition
├── patterns/
│   ├── common_patterns.md      # Universal patterns
│   └── odoo18_to_19.md        # Version-specific changes
├── fixes/
│   ├── xml_fixes.md            # XML transformation templates
│   └── javascript_fixes.md     # JS/OWL migration templates
├── scripts/
│   ├── upgrade_manifest.py     # Manifest updater
│   └── fix_rpc_service.py      # RPC service fixer
├── reference/
│   └── error_catalog.md        # 25+ common errors
└── README.md                    # This file

🛠️ Manual Intervention Required

Some issues require manual review:

• Complex business logic changes
• Custom widget rewrites
• Third-party module compatibility
• Database schema migrations
• Report template updates

🧪 Testing After Upgrade

Always test after upgrading:

# Install upgraded module
python -m odoo -d test_db -i module_name --stop-after-init

# Run with development mode
python -m odoo -d test_db --dev=xml,css,js

# Run tests
python -m odoo -d test_db --test-enable -i module_name

🔄 Version Compatibility

...