unclecatvn/agent-skills / skills/odoo-16.0
odoo-16
UnverifiedOdoo 16 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 16 or custom addons—even if the user only pastes a traceback, mentions addons/ or __manifest__.py, describes form/tree/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.
CLAUDE.md
View on GitHub# Odoo 16 Development Guide
This file is the short operational guide for agents working on Odoo 16.
> For install/setup notes, see [AGENTS.md](./AGENTS.md).
## Use These Guides
- `references/odoo-16-development-guide.md` for module naming and file layout.
- `references/odoo-16-view-guide.md` for XML views, inherited views, chatter, kanban.
- `references/odoo-16-model-guide.md` for ORM, CRUD, domains, recordsets.
- `references/odoo-16-field-guide.md` for field definitions and `group_operator=`.
- `references/odoo-16-decorator-guide.md` for `@api.depends`, `@api.ondelete`, `@api.model_create_multi`.
- `references/api-highlights.md` for version-distinguishing rules that differ from 17+.
## Odoo 16 Rules That Matter
| Concern | Odoo 16 rule |
|---------|--------------|
| List views | Use `<tree>` |
| Dynamic attributes | Use `attrs="{...}"` / `states="..."` modifiers |
| Aggregation | Use `group_operator=` |
| Delete validation | Prefer `@api.ondelete(at_uninstall=False)` |
| Batch create | Use `@api.model_create_multi` |
| Kanban card template | Use `t-name="kanban-box"` |
| Chatter | Use explicit `<div class="oe_chatter"> ... </div>` |
## Review Heuristics
- Prefer `attrs` / `states` for client-side dynamic view modifiers; direct `invisible="..."` is valid only for static/context-time visibility.
- Check the view guide before rewriting inherited XML broadly.
- Flag 18/19-only constructs such as `<list>`, `aggregator=`, `models.Constraint(...)`, or `<chatter/>`.
- 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 "Wrong:" items are what not to use in Odoo 16.
- Apply the Coding Conventions section in the guide you open. Prefer Odoo 16 runtime behavior, then the surrounding stable-addon style, when they conflict with a convention.
## Common Safe Defaults
```python
@api.model_create_multi
def create(self, vals_list):
return super().create(vals_list)
```
```xml
<tree string="Records">
<field name="name"/>
</tree>
```
```xml
<field name="amount_total" attrs="{'readonly': [('state', '!=', 'draft')]}"/>
```
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 |