odoo-17

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.md

Base Code Reference (Odoo 17)

All guides are based on analysis of Odoo 17 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

• Odoo 17 Official Documentation
• Odoo 17 Developer Reference
• Odoo 17 Coding Guidelines