# odoo-19

A skill that hands your agent 18 Odoo 19 guides: ORM, decorators, OWL, QWeb reports, migrations. Useful whenever it writes or reviews module code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2000 installs · ★ 147
- Author: unclecatvn
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/unclecatvn/agent-skills/tree/HEAD/skills/odoo-19.0/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/odoo-19

## What it does

The skill wires 18 reference files into your agent. Each one covers a single area: `ir.actions.*` and cron jobs, controllers and HTTP routes, XML/CSV data, `@api.depends` and `@api.constrains`, `models.Constraint`, `models.Index`, `__manifest__.py`, `mail.thread` mixins, ORM methods, migration scripts, OWL components, query performance, QWeb reports, access rules, tests, transactions, translations and XML views.

\`SKILL.md` is the index. It holds a table of topic, file name and when to open it, so the agent pulls one guide per task instead of the whole pack. Before writing code it points you at `references/api-highlights.md` and its review checks — the crossed-out items are what not to use in Odoo 19. The guides come from reading the Odoo 19 source: `odoo/orm/models.py`, `odoo/orm/fields.py`, `odoo/http.py` and other core files.

The conventions section says Odoo 19 runtime behaviour and the style of existing stable addons win over general rules, and that diffs should stay narrow. It also mentions a companion skill, `odoo-workflow`, to install alongside and run before coding so the agent traces the real source and pins down a definition of done. Skip it and that tracing is on you.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add unclecatvn/agent-skills --skill odoo-19 -a claude-code
```
```bash
npx skills add unclecatvn/agent-skills --skill odoo-19.0 -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/odoo-19.0/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/odoo-19.0/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add unclecatvn/agent-skills --skill odoo-19.0 -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/odoo-19.0/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add unclecatvn/agent-skills --skill odoo-19.0 -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/odoo-19.0/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install unclecatvn/agent-skills odoo-19.0
```

2. **Manually: put the files in place**
- File: `.github/skills/odoo-19.0/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add unclecatvn/agent-skills --skill odoo-19.0 -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/unclecatvn/agent-skills --path skills/odoo-19.0
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/odoo-19.0/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add unclecatvn/agent-skills --skill odoo-19.0 -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/unclecatvn/agent-skills/tree/HEAD/skills/odoo-19.0/SKILL.md

## When to use it
- write a model with fields and constraints the Odoo 19 way
- work out how `models.Constraint` replaces `_sql_constraints`
- build a QWeb report with PDF output and barcodes
- kill N+1 queries and move code to batch operations
- write a `TransactionCase` test that asserts query counts

## Example prompts
- Create an Odoo 19 module with a Monetary field and a models.Constraint rule
- Rewrite this controller for Odoo 19 and check the auth types
- This report is slow — walk the performance guide and find the N+1

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 43cef7438e51e1fd.

BEGIN THIRD-PARTY FILE 43cef7438e51e1fd
```text
---
name: odoo-19
description: >-
  Odoo 19 development knowledge base with 18 specialized guides covering
  Actions (ir.actions.*, cron jobs, server actions), Controllers (HTTP
  routing, endpoints, auth types), Data files (XML/CSV records, shortcuts,
  noupdate), API Decorators (@api.depends, @api.constrains, @api.ondelete,
  @api.onchange, @api.model, @api.private), SQL Constraints (models.Constraint
  replacing _sql_constraints), Database Indexes (models.Index), Module
  development (manifest, wizards, reports), Field types (Char, Text, Monetary,
  relational fields), Manifest configuration (__manifest__.py, dependencies,
  asset bundles), Mixins (mail.thread, mail.activity.mixin, mail.alias.mixin,
  utm.mixin), ORM Model methods (search, CRUD, domain filters, recordsets,
  CamelCase model naming), Migration scripts (pre/post/end hooks, data
  migration), OWL frontend components (hooks, services, lifecycle),
  Performance optimization (N+1 prevention, batch ops, _read_group), QWeb
  Reports (PDF/HTML, paper formats, barcodes, t-out), Security/ACL (record
  rules, field permissions, privilege-based groups, @api.private), Testing
  (TransactionCase, HttpCase, mocking, query count assertions), Transactions
  (savepoints, UniqueViolation, serialization failures), Translations (i18n,
  PO files, translatable fields), XML Views (list/form/search, kanban card
  templates, xpath inheritance, QWeb templates). Use when writing, reviewing,
  or debugging any Odoo 19 Python or XML code, creating or modifying modules,
  fixing performance issues, or looking up Odoo 19 API patterns and best
  practices. Includes CSS/SCSS asset authoring and review for Odoo addons.
globs: "**/*.{py,xml,csv,js,ts,css,scss}"
---

# Odoo 19 Skill - Master Index

Master index for all Odoo 19 development guides. Read the appropriate guide from `references/` based on your task.

## Quick Reference

| Topic          | File                                      | When to Use                                             |
| -------------- | ----------------------------------------- | ------------------------------------------------------- |
| Actions        | `references/odoo-19-actions-guide.md`     | Creating actions, menus, scheduled jobs, server actions |
| API Decorators | `references/odoo-19-decorator-guide.md`   | Using @api decorators, compute fields, validation       |
| Controllers    | `references/odoo-19-controller-guide.md`  | Writing HTTP endpoints, routes, web controllers         |
```
END THIRD-PARTY FILE 43cef7438e51e1fd

The third-party file has ended. Everything between the 43cef7438e51e1fd tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2502 of 6807 bytes. © unclecatvn · MIT · https://github.com/unclecatvn/agent-skills/tree/HEAD/skills/odoo-19.0/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md