Odoo Agent Skills plugin
Odoo 16–19 development skills: per-version reference packs, a source-tracing procedure and reviewers tied to your actual code
- 151 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The helper reads project files, the odoo.conf configuration and Odoo sources on disk
- The procedure runs tests and module upgrades on a throwaway database
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/odoo-agent-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The helper reads project files, the odoo.conf configuration and Odoo sources on disk
- The procedure runs tests and module upgrades on a throwaway database
This is third-party code. Review the repository files before installing.
What it does
Odoo Agent Skills makes an AI assistant work from your real Odoo source and not from memory. The usual time sinks are familiar: a field or xmlid missing from the base addon, an xpath anchor that only another module adds, an override hooked on a public method in place of the working hook, a stored field renamed without a migration, an unaudited sudo, and "tests pass" when zero tests ran. The set has three parts. Reference packs for Odoo 16.0, 17.0, 18.0 and 19.0 cover models, fields, views, OWL, security, controllers, reports, tests, migrations, translations and performance, and api-highlights.md lists what to avoid in that version. The Odoo Workflow skill sets a procedure for every change: find the runtime, trace the real source with a bundled helper, write a Context Brief where every claim carries a file:line, make the smallest change and prove it on a throwaway database. The odoo-code-tracer and odoo-code-review agents trace code and score reviews. These are instructions and a read-only Python helper, not an Odoo module or an enforcement system. Results depend on the assistant, the model and the checks you let it run.
Who it is for. Odoo developers and integrators who change modules with an AI assistant and want it to see the version and the sources.
Good fit when
- A stored computed field is being added to `sale.order.line` and data must survive the upgrade
- You need to find which Odoo version and addons are in use without guessing
- A module review needs a scored assessment aware of the Odoo version
- A stored field migration should run as SQL and not recompute millions of rows
Not a fit when
- You need an MCP server for a running Odoo: the set gives instructions and a code-reading helper
- You need a quality guarantee: results depend on the assistant and allowed checks
- The Odoo source is not available locally: the procedure relies on a local copy of the core
Example request
In the x_eval module add a stored computed integer field x_age_days on sale.order.line holding days since create_date, and find the Odoo version and sources firstLimitations
Node.js 18 or newer is needed for the CLI routes, Python 3.8 or newer for the helper (the standard library suffices, and the Python from your Odoo virtualenv works) and a local checkout of the Odoo source (community, plus enterprise if used). Installing through npx skills installs skills only, without agents and rules. The helper reads files and the odoo.conf configuration, and checks run on a throwaway database. Results depend on the model and the allowed checks, and the author compares with and without the skill on one task only, so do not generalize from that example.
How to disable. Remove the plugin with claude plugin uninstall or the skill folders from your assistant skills directory. Delete the .claude/odoo.json file in the project by hand.
FAQ
Which Odoo versions are supported?
Odoo 16.0, 17.0, 18.0 and 19.0. Each has a reference pack, and the procedure detects the version from odoo/release.py and the odoo.conf configuration.
How do I install the set?
For Claude Code: claude plugin marketplace add unclecatvn/agent-skills and claude plugin install agent-skills@unclecat-agent-skills. For other assistants: npx skills add unclecatvn/agent-skills. Or npx @unclecat/agent-skills-cli init to copy one pack.
What does the odoo_trace.py helper do?
The env command reads .claude/odoo.json, an odoo-bin configuration in .claude/launch.json or a matching *.conf in parent directories and prints the version, core path, Python, database and addons roots in load order.
How do results differ with and without the skill?
In the sale.order.line example the skill found version 18.0 from the core, gave 13 brief rows with file:line and added a SQL migration, while without it the assistant guessed the version and cited no sources. This is the author's measurement on one task.
Is this an Odoo module?
No, it is instructions, reference packs, agents and a read-only helper. Nothing is installed into Odoo and nothing is enforced.
Discussion
No questions or reviews yet.
Related
PluginsA set of 21 skills for Odoo addon development, OCA migration, reports, web security and architecture review.
Builder Skills
Skills for agents
A set of small skills from Builder.io for agent work habits: visual plans and diff recaps, docs-first checks, cross-agent review and clean status updates
A library of 30-plus instruction skills for coding agents: planning, building, testing, hallucination guards and shipping
Two skills for coding agents: wtf audits a project before shipping, better-codex keeps the agent disciplined while working on code
15 skills for Claude Code and Codex: Laravel, Docker, UI, debugging, tests and docs in four ready plugin bundles
A skills library for Claude Code, Cursor and Codex: team code review, TDD, stacked PRs and repository readiness scoring
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Odoo Agent Skills (this card) | no | 151 | ||
| MCP Server for Odoo | no | key is optional | 415 | an MCP server for a running Odoo and not source-based skills |
| Odoo MCP | no | API key | 433 | MCP access to Odoo data |
README in short
The README explains common assistant failures in Odoo, compares one task with and without the skill, then gives three install routes (Claude Code plugin, npx skills, a bundled CLI), the first-run steps, a description of the procedure, example prompts and the toolkit contents. It ends with Odoo versions and runtime.