odoo-18
unclecatvn/agent-skills
Odoo 18 development reference for Python models, ORM, XML views, OWL components, reports, security, and addon architecture.
What is odoo-18?
Comprehensive guide for building and maintaining Odoo 18 custom addons. Covers Python ORM queries, field definitions, API decorators, XML/CSV data files, views, QWeb reports, security rules, cron jobs, testing, migrations, and performance optimization. Use this whenever working on Odoo 18 modules or debugging addon code.
- Master index with 18 focused reference guides covering all Odoo 18 development topics
- ORM and model methods: search, domain filters, read_group, compute fields, CRUD operations
- Field types, API decorators (@api.depends, @api.constrains, @api.onchange), and validation patterns
- XML views (form, list, kanban, search), actions, menus, and QWeb report templates
- Security: access rights, record rules, field permissions, and group management
- HTTP controllers, routes, and web endpoints for custom business logic
How to install odoo-18
npx skills add https://github.com/unclecatvn/agent-skills --skill odoo-18- Odoo 18 installation or development environment
- Basic Python knowledge for model and decorator work
- Familiarity with XML for view and data file authoring
How to use odoo-18
- 1.Identify your task (e.g., creating a model, writing a view, fixing a bug)
- 2.Locate the relevant reference guide from the master index table (e.g., odoo-18-model-guide.md for ORM work)
- 3.Read the guide's quick reference and conventions section
- 4.Apply the code patterns and examples to your addon
- 5.Cross-reference api-highlights.md for deprecated or unsafe patterns to avoid
Use cases
- Building custom Odoo 18 modules with models, fields, and business logic
- Debugging tracebacks or errors in addon code by consulting the relevant reference guide
- Writing XML views, reports, and data files for module configuration
- Implementing security rules, access controls, and record-level permissions
- Optimizing slow queries and refactoring existing addon code
- Odoo developers building or maintaining custom addons
- Backend developers implementing business logic in Odoo models
- Frontend developers writing OWL components and XML views
- DevOps engineers managing Odoo module upgrades and migrations
- QA engineers writing tests for Odoo modules
odoo-18 FAQ
Use it whenever you work on Odoo 18 or custom addons—whether building features, fixing bugs, reviewing code, or debugging tracebacks mentioning addons/, __manifest__.py, or XML errors.
Yes. The skill includes odoo-18-owl-guide.md for OWL UI components, hooks, and services, plus CSS/SCSS asset authoring for Odoo addons.
Use the Quick Reference table in the master index to locate the appropriate guide file (e.g., odoo-18-security-guide.md for ACL and record rules).
Consult odoo-18-migration-guide.md for module upgrade patterns, data migration strategies, and version-specific changes.
Yes. Each guide includes a conventions section. Also read api-highlights.md before coding to identify unsafe patterns and deprecated features in Odoo 18.
Full instructions (SKILL.md)
Source of truth, from unclecatvn/agent-skills.
name: odoo-18 description: > Odoo 18 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 18 or custom addons—even if the user only pastes a traceback, mentions addons/ or manifest.py, describes form/list/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. globs: "**/*.{py,xml,csv,js,ts,css,scss}"
Odoo 18 Skill - Master Index
Master index for all Odoo 18 development guides. Read the appropriate guide from references/ based on your task.
Quick Reference
| Topic | File | When to Use |
|---|---|---|
| Actions | references/odoo-18-actions-guide.md | Creating actions, menus, scheduled jobs, server actions |
| API Decorators | references/odoo-18-decorator-guide.md | Using @api decorators, compute fields, validation |
| Controllers | references/odoo-18-controller-guide.md | Writing HTTP endpoints, routes, web controllers |
| Data Files | references/odoo-18-data-guide.md | XML/CSV data files, records, shortcuts |
| Development | references/odoo-18-development-guide.md | Creating modules, manifest, reports, security, wizards |
| Field Types | references/odoo-18-field-guide.md | Defining model fields, choosing field types |
| Manifest | references/odoo-18-manifest-guide.md | manifest.py configuration, dependencies, hooks |
| Migration | references/odoo-18-migration-guide.md | Upgrading modules, data migration, version changes |
| Mixins | references/odoo-18-mixins-guide.md | mail.thread, activities, email aliases, tracking |
| Model Methods | references/odoo-18-model-guide.md | Writing ORM queries, CRUD operations, domain filters |
| OWL Components | references/odoo-18-owl-guide.md | Building OWL UI components, hooks, services |
| Performance | references/odoo-18-performance-guide.md | Optimizing queries, fixing slow code, preventing N+1 |
| Reports | references/odoo-18-reports-guide.md | QWeb reports, PDF/HTML, templates, paper formats |
| Security | references/odoo-18-security-guide.md | Access rights, record rules, field permissions |
| Testing | references/odoo-18-testing-guide.md | Writing tests, mocking, assertions, browser testing |
| Transactions | references/odoo-18-transaction-guide.md | Handling database errors, savepoints, UniqueViolation |
| Translation | references/odoo-18-translation-guide.md | Adding translations, localization, i18n |
| Views & XML | references/odoo-18-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 18.
Apply the convention section in the guide you open. Odoo 18 runtime behavior, then existing stable-addon style, takes precedence; keep diffs focused.
- Module naming, assets, JavaScript, CSS, and SCSS: development guide.
- XML formatting and IDs: data, actions, reports, security, and views guides.
- Python, recordsets, transactions, and translations: model, field, decorator, performance, transaction, and translation guides.
File Structure
skills/odoo-18.0/
├── SKILL.md # This file - master index
└── references/ # Development guides
├── odoo-18-actions-guide.md
├── odoo-18-controller-guide.md
├── odoo-18-data-guide.md
├── odoo-18-decorator-guide.md
├── odoo-18-development-guide.md
├── odoo-18-field-guide.md
├── odoo-18-manifest-guide.md
├── odoo-18-migration-guide.md
├── odoo-18-mixins-guide.md
├── odoo-18-model-guide.md
├── odoo-18-owl-guide.md
├── odoo-18-performance-guide.md
├── odoo-18-reports-guide.md
├── odoo-18-security-guide.md
├── odoo-18-testing-guide.md
├── odoo-18-transaction-guide.md
├── odoo-18-translation-guide.md
└── odoo-18-view-guide.md
Base Code Reference (Odoo 18)
All guides are based on analysis of Odoo 18 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
External Documentation
Related skills
More from unclecatvn/agent-skills and the wider catalog.

odoo-19
Comprehensive Odoo 19 development knowledge base with 18 specialized guides for Python, XML, and frontend code.

uni-app
Vue.js-based cross-platform framework for iOS, Android, HarmonyOS, Web, and mini-programs.

migrate-nativewind-to-uniwind
Migrate React Native projects from NativeWind to Uniwind with Tailwind CSS 4 support.

uniwind
Tailwind CSS v4 styling for React Native with build-time compilation and zero runtime overhead.

shannon
Autonomous AI pentester for web apps and APIs—analyzes source code, identifies attack vectors, and executes real exploits.

configurator
Configure CCA (Continuous Clearing Auction) smart contract parameters through an interactive bulk form flow. Use when user says "configure auction", "cca auction", "setup token auction", "auction configuration", "continuous auction", or mentions CCA contracts.