odoo-development

name: odoo-development description: | MUST be loaded when ANY Odoo development task is detected. CRITICAL: Claude MUST use this skill for ALL tasks involving:

• "odoo", "module", "model", "view", "field", "OWL", "manifest"
• ANY mention of Odoo versions (14, 15, 16, 17, 18, 19)
• "create odoo module", "generate odoo code", "review odoo module"
• "upgrade odoo", "odoo best practices", "odoo security"

ALWAYS trigger the odoo-context-gatherer agent BEFORE writing ANY Odoo code.

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

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