Agent skill

Odoo Migration Copilot

by erpipe-org in erpipe-org/mcp-odoo

Plan and de-risk an Odoo version upgrade (16→17→18→19/20) using odoo-mcp's migration workbench — audit custom addons, classify upgrade-log failures into a worklist, resolve model renames, and…

MITAuto-check passedAgent Workflows

Install Odoo Migration Copilot

skills CLI
$ npx skills add erpipe-org/mcp-odoo --skill odoo-migration-copilot -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install erpipe-org/mcp-odoo odoo-migration-copilot --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/erpipe-org/mcp-odoo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/odoo-migration-copilot .claude/skills/odoo-migration-copilot && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
odoo-migration-copilot
GitHub stars
420
Token cost
~770 tokens
SKILL.md length
335 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Plan and de-risk an Odoo version upgrade (16→17→18→19/20) using odoo-mcp's migration workbench — audit custom addons, classify upgrade-log failures into a worklist, resolve model renames, and…

  • Works in 3 steps: inventory (before touching anything) → rehearsal loop → integrations (Odoo 19+ targets)
  • The user mentions upgrading/migrating Odoo versions
  • SKILL.md covers Playbook, Output format and Hard rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Odoo Migration Copilot is an agent skill from erpipe-org/mcp-odoo. Plan and de-risk an Odoo version upgrade (16→17→18→19/20) using odoo-mcp's migration workbench — audit custom addons, classify upgrade-log failures into a worklist, resolve model renames, and preview JSON-2 payloads for the XML-RPC sunset. Use when the user mentions upgrading/migrating Odoo versions, broken upgrade logs, "attrs" view errors, or XML-RPC deprecation.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Code migrations and MCP servers. It works with Odoo and Model Context Protocol. The repository describes itself as: Odoo MCP for AI agents — gated writes, multi-instance. Hosted product: https://erpipe.com. The licence is MIT.

When your agent uses it

  • The user mentions upgrading/migrating Odoo versions
  • Broken upgrade logs
  • Attrs view errors
  • XML-RPC deprecation

Example prompts

  • “/odoo-migration-copilot”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. inventory (before touching anything)
  2. rehearsal loop
  3. integrations (Odoo 19+ targets)

What it can do on your machine

Read from SKILL.md and the folder at commit 76ec136. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Odoo Migration Copilot loads about 770 tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 335 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~770

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from erpipe-org/mcp-odoo at commit 76ec136, republished under its MIT licence (© erpipe-org). 335 words, ~770 tokens.

Download SKILL.mdSave it as .claude/skills/odoo-migration-copilot/SKILL.md (or your agent's skills folder).
name
odoo-migration-copilot
description
Plan and de-risk an Odoo version upgrade (16→17→18→19/20) using odoo-mcp's migration workbench — audit custom addons, classify upgrade-log failures into a worklist, resolve model renames, and preview JSON-2 payloads for the XML-RPC sunset. Use when the user mentions upgrading/migrating Odoo versions, broken upgrade logs, "attrs" view errors, or XML-RPC deprecation.

Odoo migration copilot

You are assisting an Odoo version upgrade through the odoo-mcp server. Odoo only upgrades sequentially (16→17→18→19), custom code breaks at each hop, and the errors are cryptic — your job is to turn that into an ordered, evidence-backed worklist.

Playbook

Phase 1 — inventory (before touching anything)
  1. get_odoo_profile — confirm source version and installed modules.
  2. scan_addons_source — audit custom addons (requires ODOO_ADDONS_PATHS). Read summary.actions: every finding is already classified no_action / needs_review / needs_script.
  3. upgrade_risk_report(source_version=..., target_version=..., source_findings=<scan findings>) — merges the scan into a risk report with the same action taxonomy.
  4. Data readiness: run the odoo-data-quality-gate skill (or data_quality_report directly) on the models the addons touch — NOT NULL violations at install time are usually dirty data, cheaper to fix before the upgrade than during it.
Phase 2 — rehearsal loop
  1. The human runs the upgrade against a staging copy and pastes the failing log. Run analyze_upgrade_log(log_text=..., source_version=..., target_version=...) — it deduplicates and classifies known failures (xpath breaks, missing fields/models/external ids, NOT NULL, dependency errors, Odoo 17 attrs removal, ORM signature changes) with per-finding suggestions.
  2. For every missing-model/field finding, check lookup_model_history before concluding it was custom — many are well-known renames (account.invoice → account.move).
  3. Produce the worklist sorted needs_script → needs_review, each item with its evidence line and suggested fix. Track items across rehearsal rounds; report what the last fix resolved.
Phase 3 — integrations (Odoo 19+ targets)
  1. XML-RPC is deprecated in 19 and removed in Odoo 22 (Odoo Online: winter 2027). For each external integration call the human lists, run generate_json2_payload to preview the JSON-2 equivalent, and note that odoo-mcp itself switches with ODOO_TRANSPORT=json2.

Output format

A phase-status header (inventory / rehearsal N / integrations), the worklist table (action | category | evidence | suggested fix | status), and an honest go/no-go recommendation with the open needs_script count.

Hard rules

  • Never propose editing production during rehearsal; all fixes target the addon source or the staging database.
  • Log analysis is input-driven — ask for the log slice; never guess what an error "probably" was.
  • Data fixes go through the gated write workflow, batch by batch.

© erpipe-org, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/odoo-migration-copilot of erpipe-org/mcp-odoo.

Open the folder on GitHubat commit 76ec136

Compare with similar skills

Odoo Migration Copilot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Odoo Migration Copilot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Odoo Migration Copilot this skillerpipe-org/mcp-odoo420—~770Automated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
PicoClaw Agentsipeed/picoclaw30k—~7.2kAutomated safety check: NotesMIT
Chatgpt AppsHaohao-end/openagent8071 repos~4.9kAutomated safety check: PassApache-2.0
Chatgpt App Builderalpic-ai/skybridge2.1k—~1kAutomated safety check: PassMIT
Agent Setup Health Audittw93/Waza7.2k—~5.2kAutomated safety check: NotesMIT

Similar skills

  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • PicoClaw Agent

    sipeed/picoclaw

    Answers questions about running and changing PicoClaw, from onboarding and model selection to MCP server setup, skill loading and scheduled jobs.

    30k GitHub stars~7.2k tokensUpdated 14 days ago
    Agent WorkflowsAuto-check: notes
  • Chatgpt Apps

    Haohao-end/openagent

    Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI.

    807 GitHub starsUsed in 1 repo~4.9k tokens
    Agent WorkflowsAuto-check passed
  • Chatgpt App Builder

    alpic-ai/skybridge

    Guide developers through creating and updating ChatGPT plugins.

    2.1k GitHub stars~1k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.

    7.2k GitHub stars~5.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Record Demo

    apify/mcpc

    Official

    Record or regenerate the mcpc demo GIFs (the README hero docs/images/mcpc-demo.gif and the focused tapes in docs/vhs/) with VHS.

    983 GitHub stars~3.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from erpipe-org/mcp-odoo

  • Odoo Agency Fleet Review

    erpipe-org/mcp-odoo

    Review many client Odoo databases at once through odoo-mcp's cross-instance tools — fleet-wide accounting health, per-client aging, partial-failure triage — for agencies and partners managing 5–50…

    420 GitHub stars~699 tokensUpdated 1 mo ago
    Auto-check passed
  • Odoo Data Quality Gate

    erpipe-org/mcp-odoo

    Audit an Odoo database's data quality with evidence before trusting AI answers, importing, or migrating — duplicates, missing required values, orphaned references, format anomalies — and drive…

    420 GitHub stars~765 tokensUpdated 1 mo ago
    Auto-check passed
  • Odoo Month End Close

    erpipe-org/mcp-odoo

    Drive a month-end accounting close on Odoo through odoo-mcp — AR/AP aging, open-item and draft-invoice review, reconciliation checklists, and chatter documentation — with human sign-off at every…

    420 GitHub stars~753 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Odoo Migration Copilot

What does Odoo Migration Copilot do?

Plan and de-risk an Odoo version upgrade (16→17→18→19/20) using odoo-mcp's migration workbench — audit custom addons, classify upgrade-log failures into a worklist, resolve model renames, and…. Odoo Migration Copilot is an agent skill from erpipe-org/mcp-odoo. Plan and de-risk an Odoo version upgrade (16→17→18→19/20) using odoo-mcp's migration workbench — audit custom addons, classify upgrade-log failures into a worklist, resolve model renames, and preview JSON-2 payloads for the XML-RPC sunset.

When should I use Odoo Migration Copilot?

Odoo Migration Copilot fits situations like: the user mentions upgrading/migrating Odoo versions; broken upgrade logs; attrs view errors; XML-RPC deprecation.

How do I install Odoo Migration Copilot in Claude Code?

Run `npx skills add erpipe-org/mcp-odoo --skill odoo-migration-copilot -a claude-code`. Or copy the skill folder (skills/odoo-migration-copilot in erpipe-org/mcp-odoo) into .claude/skills/odoo-migration-copilot in your project. Claude Code loads it when a task matches its description.

How do I install Odoo Migration Copilot in Codex?

Run `npx skills add erpipe-org/mcp-odoo --skill odoo-migration-copilot -a codex`. Or copy the skill folder (skills/odoo-migration-copilot in erpipe-org/mcp-odoo) into .agents/skills/odoo-migration-copilot in your project. Codex loads it when a task matches its description.

Can I use Odoo Migration Copilot in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add erpipe-org/mcp-odoo --skill odoo-migration-copilot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/odoo-migration-copilot, .gemini/skills/odoo-migration-copilot, .github/skills/odoo-migration-copilot and .opencode/skills/odoo-migration-copilot in your project.

What does Odoo Migration Copilot need to run?

SKILL.md names no scripts, command-line tools or credentials: Odoo Migration Copilot is instructions for the agent only.

Does Odoo Migration Copilot access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Odoo Migration Copilot safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Odoo Migration Copilot use?

Odoo Migration Copilot is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Odoo Migration Copilot use?

About 770 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Odoo Migration Copilot?

Skills that share tags, products or a category with Odoo Migration Copilot: Crush Configuration (charmbracelet/crush, 29k stars), PicoClaw Agent (sipeed/picoclaw, 30k stars), Chatgpt Apps (Haohao-end/openagent, 807 stars) and Chatgpt App Builder (alpic-ai/skybridge, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Odoo Migration Copilot?

erpipe-org (a GitHub organization) maintains it in erpipe-org/mcp-odoo, which has 420 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 25, 2026.

Source: erpipe-org/mcp-odoo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.