Odoo Agent Skills
Teach your AI agent how to work with Odoo. Install pre-built skills that handle model inspection, accounting, inventory, manufacturing, and runtime customization.
What are skills?
Skills are SKILL.md files that teach AI coding agents how to work with specific domains. Each skill contains instructions, field mappings, recipes, and pitfall rules that the agent reads before working on a task.
When you install a skill, your agent knows:
- Which Odoo models and fields to query
- The correct field names for your Odoo version (17, 18, 19+)
- Common mistakes to avoid (fields that don't exist, wrong domain syntax)
- Whether an operation is safe to do at runtime or requires a custom module
How they're made
Every skill is produced by an RL pipeline that runs real agent tasks on live Odoo instances. When the agent makes a mistake (queries a non-existent field, uses wrong domain syntax), the error is captured and distilled into a pitfall rule. Skills are validated against hold-out tasks to prove they actually help.
Results from validation on 18 held-out tasks:
| Metric | Without skills | With skills | Delta |
|---|---|---|---|
| Odoo errors per task | 0.94 | 0.28 | -70% |
| Tool calls per task | 3.78 | 3.06 | -19% |
| Completion rate | 100% | 100% | — |
The three tiers
Skills are organized by what they can do to your Odoo instance:
| Tier | What it can do | Where it's safe |
|---|---|---|
| Read | Inspect models, query records, count, audit, run health checks. Guides the agent toward read-only operations. | Production, staging, demo — anywhere. |
| Write | Set defaults, create custom fields, modify window actions, build automations. Mutates state. | Production only when you want changes. |
| Demo | Same as write, but every artifact is tagged for clean rollback. | Sandbox, demo, training instances. |
Skills are guidance, not permissions. A read-tier skill instructs the agent to avoid write operations but does not enforce this at the tool level. For hard enforcement, use ODOO_READ_ONLY=true on your MCP server.
Quick install
# Install all skills
npx skills add oconsole/odoo-skills
# Install a single skill
npx skills add oconsole/odoo-skills --skill odoo-model-inspect
# Install globally (available in all projects)
npx skills add oconsole/odoo-skills --all --global
See Installation for setup with specific agents.