unclecatvn/agent-skills / skills/odoo-18.0
odoo-18
VerifiedOdoo 18 development reference for Python models and ORM (search, domain, read_group, compute fields), XML/CSV data and views, OWL/JS client code, QWeb reports, security (ACL, record rules, groups), cron and server actions, migrations and module upgrades, tests, i18n, and performance. Use this skill whenever work involves Odoo 18 or custom addons—even if the user only pastes a traceback, mentions addons/ or __manifest__.py, describes form/list/kanban/XML errors, HTTP controllers, or business rules on models—including building features, fixing bugs, refactoring, or reviewing addon code. Includes CSS/SCSS asset authoring and review for Odoo addons.
AGENTS.md
View on GitHub# Odoo 18 Documentation - AI Agents Setup
Setup guide for using Odoo 18 documentation with AI coding assistants (Cursor, Claude Code, Windsurf, Aider, etc.).
## Quick Start
### Install via skills.sh (Recommended)
```bash
# Add Odoo 18 skill to your project
npx skills add unclecatvn/agent-skills
```
Visit [https://skills.sh/](https://skills.sh/) for more installation options.
### Cursor IDE - Remote Rule
Configure once in Cursor settings:
- `Settings` → `Rules` → `Add Remote Rule`
- Source: `Git Repository`
- URL: `git@github.com:unclecatvn/agent-skills.git`
- Branch: `18.0`
- Subfolder: `skills/odoo-18.0/`
---
## Documentation Structure
```
skills/odoo-18.0/
├── SKILL.md # Master index (all agents)
├── references/ # Development guides (18 files)
│ ├── odoo-18-actions-guide.md # ir.actions.*, cron, bindings
│ ├── odoo-18-controller-guide.md # HTTP, routing, controllers
│ ├── odoo-18-data-guide.md # XML/CSV data files, records
│ ├── odoo-18-decorator-guide.md # @api decorators
│ ├── odoo-18-development-guide.md # Manifest, wizards (overview)
│ ├── odoo-18-field-guide.md # Field types, parameters
│ ├── odoo-18-manifest-guide.md # __manifest__.py reference
│ ├── odoo-18-mixins-guide.md # mail.thread, activities, etc.
│ ├── odoo-18-model-guide.md # ORM, CRUD, search, domain
│ ├── odoo-18-migration-guide.md # Migration scripts, hooks
│ ├── odoo-18-owl-guide.md # OWL components, services
│ ├── odoo-18-performance-guide.md # N+1 prevention, optimization
│ ├── odoo-18-reports-guide.md # QWeb reports, PDF/HTML
│ ├── odoo-18-security-guide.md # ACL, record rules, security
│ ├── odoo-18-testing-guide.md # Test classes, decorators
│ ├── odoo-18-transaction-guide.md # Savepoints, errors
│ ├── odoo-18-translation-guide.md # Translations, i18n
│ └── odoo-18-view-guide.md # XML views, QWeb
├── CLAUDE.md # Claude Code specific
└── AGENTS.md # THIS FILE - setup guide
```
---
## Guide Reference
| File | Purpose | When to Use |
|------|---------|-------------|
| `SKILL.md` | Master index for all guides | Find the right guide for your task |
| `references/odoo-18-actions-guide.md` | Actions (window, URL, server, cron) | Creating actions, menus, scheduled jobs |
| `references/odoo-18-controller-guide.md` | HTTP controllers, routing | Writing endpoints |
| `references/odoo-18-data-guide.md` | XML/CSV data files, records | Creating data files |
| `references/odoo-18-decorator-guide.md` | @api decorators usage | Using @api decorators |
| `references/odoo-18-development-guide.md` | Module structure, wizards | Creating new modules |
| `references/odoo-18-field-guide.md` | Field types, parameters | Defining model fields |
| `references/odoo-18-manifest-guide.md` | __manifest__.py reference | Configuring module manifest |
| `references/odoo-18-mixins-guide.md` | mail.thread, activities, mixins | Adding messaging, activities |
| `references/odoo-18-model-guide.md` | ORM methods, CRUD, domains | Writing model methods |
| `references/odoo-18-migration-guide.md` | Migration scripts, hooks | Upgrading modules |
| `references/odoo-18-owl-guide.md` | OWL components, hooks, services | Building OWL UI |
| `references/odoo-18-performance-guide.md` | Performance optimization | Fixing slow code |
| `references/odoo-18-reports-guide.md` | QWeb reports, templates | Creating reports |
| `references/odoo-18-security-guide.md` | ACL, record rules, security | Configuring security |
| `references/odoo-18-testing-guide.md` | Test classes, decorators, mocking | Writing tests |
| `references/odoo-18-transaction-guide.md` | Database transactions, error handling | Savepoints, UniqueViolation |
| `references/odoo-18-translation-guide.md` | Translations, localization, i18n | Adding translations |
| `references/odoo-18-view-guide.md` | XML views, actions, menus | Writing view XML |
---
## AI Agent Configuration
### Cursor IDE
| Setting | Value |
|---------|-------|
| Source | Git Repository |
| URL | `git@github.com:unclecatvn/agent-skills.git` |
| Branch | `18.0` |
| Subfolder | `skills/odoo-18.0/` |
**Globs patterns used by Cursor:**
| File | globs Pattern |
|------|---------------|
| `SKILL.md` | `**/*.{py,xml}` |
| `references/odoo-18-actions-guide.md` | `**/*.{py,xml}` |
| `references/odoo-18-controller-guide.md` | `**/controllers/**/*.py` |
| `references/odoo-18-data-guide.md` | `**/*.{xml,csv}` |
| `references/odoo-18-decorator-guide.md` | `**/models/**/*.py` |
| `references/odoo-18-development-guide.md` | `**/*.{py,xml,csv}` |
| `references/odoo-18-field-guide.md` | `**/models/**/*.py` |
| `references/odoo-18-manifest-guide.md` | `**/__manifest__.py` |
| `references/odoo-18-mixins-guide.md` | `**/models/**/*.py` |
| `references/odoo-18-model-guide.md` | `**/models/**/*.py` |
| `references/odoo-18-migration-guide.md` | `**/migrations/**/*.py` |
| `references/odoo-18-owl-guide.md` | `static/src/**/*.{js,xml}` |
| `references/odoo-18-performance-guide.md` | `**/*.{py,xml}` |
| `references/odoo-18-reports-guide.md` | `**/report/**/*.xml` |
| `references/odoo-18-security-guide.md` | `**/security/**/*.{csv,xml}` |
| `references/odoo-18-testing-guide.md` | `**/tests/**/*.py` |
| `references/odoo-18-transaction-guide.md` | `**/models/**/*.py` |
| `references/odoo-18-translation-guide.md` | `**/*.{py,js,xml}` |
| `references/odoo-18-view-guide.md` | `**/views/**/*.xml` |
### Claude Code
```bash
# Install via skills.sh
npx skills add unclecatvn/agent-skills
```
Claude Code reads:
- `CLAUDE.md` - Project overview and quick reference
- `SKILL.md` - Master index for all guides
- Individual guides in `references/` - Detailed information
### Other Agents
| Agent | Setup |
|-------|-------|
| Windsurf | Same as Cursor (uses `.mdc` files) |
| Continue | Place `CLAUDE.md` or `SKILL.md` in root |
| Aider | Place `CLAUDE.md` or add to prompt |
| OpenCode | Copy skill folder to project - no additional config needed |
---
## Cursor / Claude Skills Folder
After installing via `npx skills add unclecatvn/agent-skills`, the skill is placed at:
```
.cursor/skills/
└── odoo-18/
└── SKILL.md
.claude/skills/
└── odoo-18/
└── SKILL.md
```
---
## Key Odoo 18 Changes
| Change | Old | New |
|--------|-----|-----|
| List view tag | `<tree>` | `<list>` |
| Dynamic attributes | `attrs="{'invisible': [...]}"` | `invisible="..."` |
| Delete validation | Override `unlink()` | `@api.ondelete(at_uninstall=False)` |
| Field aggregation | `group_operator=` | `aggregator=` |
| SQL queries | `cr.execute()` | `SQL` class with `execute_query_dict()` |
## Coding Conventions
Before writing code, run the `odoo-workflow` skill if it is installed (trace the real
source, Context Brief with `file:line`, definition of done); install it alongside this pack.
Read `references/api-highlights.md` before writing code and apply its Quick review
checks: the ❌ items are what not to use in Odoo 18.
Apply the Coding Conventions section in the guide you open. Odoo 18 runtime
behavior takes precedence, followed by the surrounding stable-addon style;
keep convention-only changes focused. The common source is the [Odoo Coding
Guidelines](https://raw.githubusercontent.com/odoo/documentation/17.0/content/contributing/development/coding_guidelines.rst).
- Use the development guide for module layout, asset, JavaScript, CSS, and
SCSS conventions.
- Use the data, action, report, security, and view guides for XML formatting
and external IDs.
- Use the model, field, decorator, performance, transaction, and translation
guides for Python, recordsets, context, database work, and i18n.
---
## Repository
**URL**: `git@github.com:unclecatvn/agent-skills.git`
**Branch**: `18.0`
**License**: MIT
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |