Odoo 17 Skill - Master Index
Master index for all Odoo 17 development guides. Read the appropriate guide from references/ based on your task.
Quick Reference
| Topic | File | When to Use |
|---|---|---|
| Actions | references/odoo-17-actions-guide.md |
Creating actions, menus, scheduled jobs, server actions |
| API Decorators | references/odoo-17-decorator-guide.md |
Using @api decorators, compute fields, validation |
| Controllers | references/odoo-17-controller-guide.md |
Writing HTTP endpoints, routes, web controllers |
| Data Files | references/odoo-17-data-guide.md |
XML/CSV data files, records, shortcuts |
| Development | references/odoo-17-development-guide.md |
Creating modules, manifest, reports, security, wizards |
| Field Types | references/odoo-17-field-guide.md |
Defining model fields, choosing field types |
| Manifest | references/odoo-17-manifest-guide.md |
manifest.py configuration, dependencies, hooks |
| Migration | references/odoo-17-migration-guide.md |
Upgrading modules, data migration, version changes |
| Mixins | references/odoo-17-mixins-guide.md |
mail.thread, activities, email aliases, tracking |
| Model Methods | references/odoo-17-model-guide.md |
Writing ORM queries, CRUD operations, domain filters |
| OWL Components | references/odoo-17-owl-guide.md |
Building OWL UI components, hooks, services |
| Performance | references/odoo-17-performance-guide.md |
Optimizing queries, fixing slow code, preventing N+1 |
| Reports | references/odoo-17-reports-guide.md |
QWeb reports, PDF/HTML, templates, paper formats |
| Security | references/odoo-17-security-guide.md |
Access rights, record rules, field permissions |
| Testing | references/odoo-17-testing-guide.md |
Writing tests, mocking, assertions, browser testing |
| Transactions | references/odoo-17-transaction-guide.md |
Handling database errors, savepoints, UniqueViolation |
| Translation | references/odoo-17-translation-guide.md |
Adding translations, localization, i18n |
| Views & XML | references/odoo-17-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 ❌ items are what not to use in Odoo 17.
Apply the relevant convention section in the guide you open. Conventions are advisory: preserve the style of an existing stable addon and keep diffs focused. When guidance conflicts, prefer Odoo 17 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-17.0/
├── SKILL.md # This file - master index
└── references/ # Development guides
├── odoo-17-actions-guide.md
├── odoo-17-controller-guide.md
├── odoo-17-data-guide.md
├── odoo-17-decorator-guide.md
├── odoo-17-development-guide.md
├── odoo-17-field-guide.md
├── odoo-17-manifest-guide.md
├── odoo-17-migration-guide.md
├── odoo-17-mixins-guide.md
├── odoo-17-model-guide.md
├── odoo-17-owl-guide.md
├── odoo-17-performance-guide.md
├── odoo-17-reports-guide.md
├── odoo-17-security-guide.md
├── odoo-17-testing-guide.md
├── odoo-17-transaction-guide.md
├── odoo-17-translation-guide.md
└── odoo-17-view-guide.mdBase Code Reference (Odoo 17)
All guides are based on analysis of Odoo 17 source code:
odoo/models.py- ORM implementationodoo/fields.py- Field typesodoo/api.py- Decoratorsodoo/http.py- HTTP layerodoo/exceptions.py- Exception typesodoo/tools/translate.py- Translation systemodoo/addons/base/models/res_lang.py- Language modeladdons/web/static/src/core/l10n/translation.js- JS translations