PluginBench
Skill
Review
Audit score 70

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
Prerequisites
  • Odoo 18 installation or development environment
  • Basic Python knowledge for model and decorator work
  • Familiarity with XML for view and data file authoring
Claude Code
Cursor
Windsurf
Cline

How to use odoo-18

  1. 1.Identify your task (e.g., creating a model, writing a view, fixing a bug)
  2. 2.Locate the relevant reference guide from the master index table (e.g., odoo-18-model-guide.md for ORM work)
  3. 3.Read the guide's quick reference and conventions section
  4. 4.Apply the code patterns and examples to your addon
  5. 5.Cross-reference api-highlights.md for deprecated or unsafe patterns to avoid

Use cases

Good for
  • 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
Who it's for
  • 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

When should I use this skill?

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.

Does this cover OWL and JavaScript?

Yes. The skill includes odoo-18-owl-guide.md for OWL UI components, hooks, and services, plus CSS/SCSS asset authoring for Odoo addons.

How do I find guidance on a specific topic?

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

What if I need to migrate from an older Odoo version?

Consult odoo-18-migration-guide.md for module upgrade patterns, data migration strategies, and version-specific changes.

Are there coding conventions I should follow?

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

TopicFileWhen to Use
Actionsreferences/odoo-18-actions-guide.mdCreating actions, menus, scheduled jobs, server actions
API Decoratorsreferences/odoo-18-decorator-guide.mdUsing @api decorators, compute fields, validation
Controllersreferences/odoo-18-controller-guide.mdWriting HTTP endpoints, routes, web controllers
Data Filesreferences/odoo-18-data-guide.mdXML/CSV data files, records, shortcuts
Developmentreferences/odoo-18-development-guide.mdCreating modules, manifest, reports, security, wizards
Field Typesreferences/odoo-18-field-guide.mdDefining model fields, choosing field types
Manifestreferences/odoo-18-manifest-guide.mdmanifest.py configuration, dependencies, hooks
Migrationreferences/odoo-18-migration-guide.mdUpgrading modules, data migration, version changes
Mixinsreferences/odoo-18-mixins-guide.mdmail.thread, activities, email aliases, tracking
Model Methodsreferences/odoo-18-model-guide.mdWriting ORM queries, CRUD operations, domain filters
OWL Componentsreferences/odoo-18-owl-guide.mdBuilding OWL UI components, hooks, services
Performancereferences/odoo-18-performance-guide.mdOptimizing queries, fixing slow code, preventing N+1
Reportsreferences/odoo-18-reports-guide.mdQWeb reports, PDF/HTML, templates, paper formats
Securityreferences/odoo-18-security-guide.mdAccess rights, record rules, field permissions
Testingreferences/odoo-18-testing-guide.mdWriting tests, mocking, assertions, browser testing
Transactionsreferences/odoo-18-transaction-guide.mdHandling database errors, savepoints, UniqueViolation
Translationreferences/odoo-18-translation-guide.mdAdding translations, localization, i18n
Views & XMLreferences/odoo-18-view-guide.mdWriting 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 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