Odoo 18 Skill - Master Index

Master index for all Odoo 18 guides. Use this to quickly find the appropriate guide for your task.

Quick Reference

Guide Index

Actions Guide

File: odoo-18-actions-guide.md

When to read:

• •Creating window actions, URL actions, server actions
• •Setting up scheduled/cron jobs
• •Configuring report actions
• •Creating client-side actions
• •Understanding action bindings

Controller Guide

File: odoo-18-controller-guide.md

When to read:

• •Creating HTTP endpoints
• •Writing web controllers
• •Setting up routes
• •Choosing auth types (user, public, none)
• •Handling JSON vs HTTP responses

Data Files Guide

File: odoo-18-data-guide.md

When to read:

• •Creating XML data files
• •Understanding record, field, delete, function tags
• •Using CSV data files
• •Working with shortcuts (menuitem, template, asset)
• •Understanding noupdate attribute

Decorator Guide

File: odoo-18-decorator-guide.md

When to read:

• •Using @api.depends for computed fields
• •Using @api.constrains for validation
• •Using @api.ondelete (Odoo 18) for delete validation
• •Using @api.onchange for form UI updates
• •Using @api.model for model-level methods

Development Guide

File: odoo-18-development-guide.md

When to read:

• •Creating new modules
• •Writing __manifest__.py
• •Setting up module structure
• •Configuring access rights (CSV)
• •Creating record rules
• •Building wizards (TransientModel)
• •Creating reports

Field Guide

File: odoo-18-field-guide.md

When to read:

• •Defining new model fields
• •Choosing appropriate field types (Char, Text, Monetary, etc.)
• •Setting field parameters (required, default, index, etc.)
• •Creating computed fields
• •Setting up relational fields (Many2one, One2many, Many2many)

Manifest Guide

File: odoo-18-manifest-guide.md

When to read:

• •Configuring __manifest__.py
• •Setting up module dependencies
• •Defining asset bundles
• •Declaring external dependencies (Python, binary)
• •Using module hooks (pre_init, post_init, uninstall)
• •Understanding auto_install behavior

Migration Guide

File: odoo-18-migration-guide.md

When to read:

• •Upgrading modules from earlier versions
• •Writing migration scripts (pre, post, end)
• •Handling data migration
• •Using module hooks (pre_init, post_init, uninstall)
• •Version-specific migration logic

Mixins Guide

File: odoo-18-mixins-guide.md

When to read:

• •Using mail.thread (messaging, chatter, field tracking)
• •Setting up mail.alias.mixin (email aliases)
• •Adding mail.activity.mixin (activities)
• •Using utm.mixin (campaign tracking)
• •Website publishing (website.published.mixin)
• •SEO metadata (website.seo.metadata)
• •Customer ratings (rating.mixin)

Model Guide

File: odoo-18-model-guide.md

When to read:

• •Writing model methods
• •Using ORM queries (search, read, create, write, unlink)
• •Working with domain filters
• •Understanding recordsets and prefetching
• •Batch operations

OWL Guide

File: odoo-18-owl-guide.md

When to read:

• •Building OWL components
• •Using hooks (useState, onWillStart, onMounted, etc.)
• •Using services (orm, rpc, action, dialog, notification)
• •Component lifecycle management
• •JavaScript/OWL translations with _t()

Performance Guide

File: odoo-18-performance-guide.md

When to read:

• •Fixing N+1 query problems
• •Optimizing slow code
• •Reducing database queries
• •Understanding prefetch behavior
• •Using search_read(), read_group(), mapped(), filtered()

Reports Guide

File: odoo-18-reports-guide.md

When to read:

• •Creating QWeb reports (PDF/HTML)
• •Writing report templates
• •Configuring paper formats
• •Creating custom reports with _get_report_values
• •Adding barcodes to reports
• •Using custom fonts
• •Creating translatable reports

Security Guide

File: odoo-18-security-guide.md

When to read:

• •Configuring access rights (ACL)
• •Creating record rules
• •Understanding field-level access
• •Multi-company security
• •Preventing security pitfalls (SQL injection, XSS)
• •Public/Portal user security

Testing Guide

File: odoo-18-testing-guide.md

When to read:

• •Writing unit tests (TransactionCase)
• •Writing browser tests (HttpCase)
• •Using test decorators (@tagged, @users, @warmup)
• •Testing with Form class
• •Mocking external APIs
• •Query count assertions

Translation Guide

File: odoo-18-translation-guide.md

When to read:

• •Adding translatable strings in Python (_(), _lt())
• •Adding translatable strings in JavaScript (_t())
• •Creating translatable QWeb templates
• •Setting up translated fields (translate=True)
• •Managing PO files
• •Exporting/importing translations
• •Working with languages (res.lang)

Transaction Guide

File: odoo-18-transaction-guide.md

When to read:

• •Handling database errors (UniqueViolation, NotNullViolation)
• •Using savepoints for error isolation
• •Understanding transaction states
• •Dealing with serialization failures
• •Commit and rollback patterns

View Guide

File: odoo-18-view-guide.md

When to read:

• •Writing list views (use <list> not <tree> in Odoo 18)
• •Writing form views
• •Writing search views
• •Creating view inheritance with xpath
• •Writing QWeb templates
• •Creating actions and menus

File Structure

agent-skills/skills/odoo/18.0/
├── SKILL.md                       # THIS FILE - master index
├── dev/                           # Development guides folder
│   ├── 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                      # AI agents setup

Base Code Reference (Odoo 18)

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

For setup instructions with different AI IDEs, see AGENTS.md