letzdoo/odoo-development

Odoo Development Skill Index

CRITICAL: Before writing ANY Odoo code, Claude MUST invoke the odoo-context-gatherer agent to compile relevant patterns for the task.

MANDATORY WORKFLOW:

1. Detect/confirm Odoo version (NEVER skip)
2. Invoke odoo-development:odoo-context-gatherer agent with task description
3. Use returned context patterns for code generation
4. NEVER skip step 2 - context gathering is REQUIRED

╔══════════════════════════════════════════════════════════════════════════════╗
║  BEFORE generating Odoo code, you MUST:                                      ║
║  1. Determine the target Odoo version                                        ║
║  2. Invoke odoo-context-gatherer agent with task description                 ║
║  3. Use the patterns returned by the agent                                   ║
║                                                                              ║
║  DO NOT generate Odoo code without context from the agent.                   ║
╚══════════════════════════════════════════════════════════════════════════════╝

Usage: This is a lightweight discovery index. DO NOT read full skill files unless needed. Use Read tool on specific file paths only when you need the detailed pattern.

Quick Reference (Copy-Paste Ready)

Field Declarations

# Basic fields
name = fields.Char(required=True)
active = fields.Boolean(default=True)
sequence = fields.Integer(default=10)
amount = fields.Float(digits=(16, 2))
date = fields.Date(default=fields.Date.today)
note = fields.Text()
html_content = fields.Html()

# Relational
partner_id = fields.Many2one('res.partner', ondelete='cascade')
tag_ids = fields.Many2many('my.tag', string='Tags')
line_ids = fields.One2many('my.line', 'parent_id')

# Computed
total = fields.Float(compute='_compute_total', store=True)
@api.depends('line_ids.amount')
def _compute_total(self):
    for rec in self:
        rec.total = sum(rec.line_ids.mapped('amount'))

Model Declaration

class MyModel(models.Model):
    _name = 'my.model'
    _description = 'My Model'
    _inherit = ['mail.thread', 'mail.activity.mixin']
    _order = 'sequence, id'

View Visibility (v17+ vs v14-16)

<!-- v17+: direct attribute -->
<field name="x" invisible="state != 'draft'"/>
<field name="y" readonly="is_locked"/>

<!-- v14-16: attrs dict -->
<field name="x" attrs="{'invisible': [('state', '!=', 'draft')]}"/>

Skill Discovery Index

| Intent / Keywords | Skill File | Description | |-------------------|------------|-------------| | fields, char, many2one, one2many, selection | skills/field-type-reference.md | All field types with attributes | | computed, depends, inverse, search | skills/computed-field-patterns.md | Computed field patterns | | constraint, validation, check | skills/constraint-patterns.md | SQL and Python constraints | | onchange, dynamic, domain | skills/onchange-dynamic-patterns.md | Form field dynamics | | view, form, tree, kanban, search | skills/xml-view-patterns.md | XML view patterns | | widget, statusbar, badge, image | skills/widget-field-patterns.md | Field widgets | | qweb, template, t-if, t-foreach | skills/qweb-template-patterns.md | QWeb templating | | action, window, server, client | skills/action-patterns.md | Action patterns | | menu, navigation, menuitem | skills/menu-navigation-patterns.md | Menu structure | | security, access, rule, group | skills/odoo-security-guide.md | Security configuration | | workflow, state, statusbar, approval | skills/workflow-state-patterns.md | State machines | | wizard, transient, dialog | skills/wizard-patterns.md | Wizard patterns | | report, pdf, qweb, print | skills/report-patterns.md | PDF reports | | cron, scheduled, automation | skills/cron-automation-patterns.md | Scheduled actions | | controller, http, api, rest, json | skills/controller-api-patterns.md | HTTP controllers | | mail, email, chatter, activity | skills/mail-notification-patterns.md | Mail integration | | multi-company, company, currency | skills/multi-company-patterns.md | Multi-company | | inherit, extend, override | skills/inheritance-patterns.md | Model/view inheritance | | migration, upgrade, version | skills/data-migration-patterns.md | Data migration | | website, portal, public | skills/website-integration-patterns.md | Website integration | | external, api, webhook, sync | skills/external-api-patterns.md | External APIs | | logging, debug, error | skills/logging-debugging-patterns.md | Logging/debugging | | stock, inventory, warehouse, move | skills/stock-inventory-patterns.md | Stock operations | | account, invoice, journal, payment | skills/accounting-patterns.md | Accounting | | sale, order, quotation, crm, lead | skills/sale-crm-patterns.md | Sales/CRM | | hr, employee, contract, leave | skills/hr-employee-patterns.md | HR patterns | | domain, filter, search, operator | skills/domain-filter-patterns.md | Search domains | | sequence, number, reference | skills/sequence-numbering-patterns.md | Auto-numbering | | purchase, vendor, procurement | skills/purchase-procurement-patterns.md | Purchasing | | project, task, timesheet | skills/project-task-patterns.md | Project management | | context, env, sudo, with_context | skills/context-environment-patterns.md | Environment/context | | exception, error, validation | skills/error-handling-patterns.md | Error handling | | portal, token, access, share | skills/portal-access-patterns.md | Portal access | | dashboard, kpi, analytics, graph | skills/dashboard-kpi-patterns.md | Dashboards | | settings, config, parameter | skills/config-settings-patterns.md | Module settings | | translation, i18n, language | skills/translation-i18n-patterns.md | Translations | | assets, js, css, scss, bundle | skills/assets-bundling-patterns.md | Asset bundling | | variant, attribute, product | skills/product-variant-patterns.md | Product variants | | pricelist, price, discount | skills/pricelist-pricing-patterns.md | Pricing | | uom, unit, measure, conversion | skills/uom-patterns.md | Units of measure | | lot, serial, batch, expiry | skills/lot-serial-patterns.md | Lot/serial tracking | | import, export, csv, excel | skills/import-export-patterns.md | Data import/export | | tax, fiscal, vat | skills/tax-fiscal-patterns.md | Tax configuration | | owl, component, frontend, javascript | skills/odoo-owl-components.md | OWL components | | test, unittest, integration | skills/odoo-test-patterns.md | Testing | | performance, optimize, index | skills/odoo-performance-guide.md | Performance | | manifest, module, depends | skills/odoo-module-generator.md | Module structure | | version, 14, 15, 16, 17, 18, 19 | skills/odoo-version-knowledge.md | Version differences | | binary, attachment, file, image | skills/attachment-binary-patterns.md | File handling |

Version-Specific Patterns

For version-specific code, check these skill files:

• skills/odoo-version-knowledge.md - Breaking changes by version
• skills/odoo-owl-components.md - OWL 1.x (v15) / 2.x (v16-18) / 3.x (v19)
• Version-specific files: skills/{pattern}-{version}.md

How to Use This Index

1. Identify keywords from user's request
2. Find matching row in the index table
3. Read only the specific skill file using Read tool
4. Use patterns from that file
5. Don't preload - only load what you need

Example:

User: "Create a computed field that sums order lines"
→ Keywords: computed, depends
→ Read: skills/computed-field-patterns.md
→ Use the pattern, don't keep file in context