odoo-16

Odoo 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), cr

SKILL.md

GitHub

Odoo 16 Skill - Master Index

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

Quick Reference

Topic File When to Use
Actions references/odoo-16-actions-guide.md Creating actions, menus, scheduled jobs, server actions
API Decorators references/odoo-16-decorator-guide.md Using @api decorators, compute fields, validation
Controllers references/odoo-16-controller-guide.md Writing HTTP endpoints, routes, web controllers
Data Files references/odoo-16-data-guide.md XML/CSV data files, records, shortcuts
Development references/odoo-16-development-guide.md Creating modules, manifest, reports, security, wizards
Field Types references/odoo-16-field-guide.md Defining model fields, choosing field types
Manifest references/odoo-16-manifest-guide.md manifest.py configuration, dependencies, hooks
Migration references/odoo-16-migration-guide.md Upgrading modules, data migration, version changes
Mixins references/odoo-16-mixins-guide.md mail.thread, activities, email aliases, tracking
Model Methods references/odoo-16-model-guide.md Writing ORM queries, CRUD operations, domain filters
OWL Components references/odoo-16-owl-guide.md Building OWL UI components, hooks, services
Performance references/odoo-16-performance-guide.md Optimizing queries, fixing slow code, preventing N+1
Reports references/odoo-16-reports-guide.md QWeb reports, PDF/HTML, templates, paper formats
Security references/odoo-16-security-guide.md Access rights, record rules, field permissions
Testing references/odoo-16-testing-guide.md Writing tests, mocking, assertions, browser testing
Transactions references/odoo-16-transaction-guide.md Handling database errors, savepoints, UniqueViolation
Translation references/odoo-16-translation-guide.md Adding translations, localization, i18n
Views & XML references/odoo-16-view-guide.md Writing XML views, actions, menus, QWeb templates

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 "Wrong:" items are what not to use in Odoo 16.

Apply the relevant convention section in the guide you open. The conventions are advisory: preserve the style of an existing stable addon and keep diffs focused. When guidance conflicts, prefer Odoo 16 runtime/source behavior, then the surrounding addon style, then the convention.

  • Module layout and asset placement: development and controller guides.
  • XML formatting and external IDs: data, view, action, report, and security guides.
  • Python naming, imports, recordsets, transactions, and translations: model, field, decorator, performance, transaction, and translation guides.
  • JavaScript and CSS/SCSS: development guide.

File Structure

skills/odoo-16.0/
├── SKILL.md                          # This file - master index
└── references/                       # Development guides
    ├── odoo-16-actions-guide.md
    ├── odoo-16-controller-guide.md
    ├── odoo-16-data-guide.md
    ├── odoo-16-decorator-guide.md
    ├── odoo-16-development-guide.md
    ├── odoo-16-field-guide.md
    ├── odoo-16-manifest-guide.md
    ├── odoo-16-migration-guide.md
    ├── odoo-16-mixins-guide.md
    ├── odoo-16-model-guide.md
    ├── odoo-16-owl-guide.md
    ├── odoo-16-performance-guide.md
    ├── odoo-16-reports-guide.md
    ├── odoo-16-security-guide.md
    ├── odoo-16-testing-guide.md
    ├── odoo-16-transaction-guide.md
    ├── odoo-16-translation-guide.md
    └── odoo-16-view-guide.md

Base Code Reference (Odoo 16)

All guides are based on analysis of Odoo 16 source code:

  • odoo/models.py - ORM implementation
  • odoo/fields.py - Field types
  • odoo/api.py - Decorators
  • odoo/http.py - HTTP layer
  • odoo/exceptions.py - Exception types
  • odoo/tools/translate.py - Translation system
  • odoo/addons/base/models/res_lang.py - Language model
  • addons/web/static/src/core/l10n/translation.js - JS translations

External Documentation