Odoo 19 Module Development — AI Skill

AI skill that teaches Claude Code, Cursor, Windsurf, Copilot, and 10+ AI assistants how to build production-grade Odoo 19 modules with modern UI capabilities.

Installation

# Install globally from npm
npm install -g odoo19-module-development-skill

# Install skill for your AI assistant (default: claude)
odoo-skill init

# Or specify your AI assistant
odoo-skill init --ai cursor
odoo-skill init --ai windsurf
odoo-skill init --ai copilot
odoo-skill init --ai all        # Install for all supported assistants

Supported AI Assistants

claude · cursor · windsurf · copilot · roocode · gemini · kiro · codex · qoder · trae · opencode · continue · codebuddy · droid · antigravity

Update to Latest Version

odoo-skill update

What This Skill Does

When you work on any Odoo 19 .py or .xml file, your AI assistant automatically loads this skill and follows Odoo 19 best practices — no need to repeat instructions every conversation.

Covers

• Module scaffolding — correct directory structure, __manifest__.py, __init__.py chains
• Models & ORM — fields, decorators (@api.depends, @api.ondelete, @api.private), models.Constraint, batch create()
• Views — <list> (not <tree>), invisible="..." (not attrs=), search views without <group expand='0'>
• Security — Odoo 19 privilege system (res.groups.privilege), ACL CSV, record rules
• Custom UI — HTML/JS/CSS dashboards via OWL components + ir.actions.client, integrated with ui-ux-pro-max design system
• Server access — auto-SSH for inspection when credentials are provided (read-only by default, deploy only on explicit request)
• 18 deep-dive references — actions, decorators, controllers, data, fields, manifest, migration, mixins, models, OWL, performance, reports, security, testing, transactions, translations, views

Odoo 19 Breaking Changes (auto-enforced)

| Old | New | |-----|-----| | <tree> | <list> | | attrs="{'invisible': [...]}" | invisible="expression" | | _sql_constraints | models.Constraint(...) | | category_id on groups | privilege_id + res.groups.privilege | | t-esc | t-out | | read_group() | _read_group() | | Override unlink() | @api.ondelete(at_uninstall=False) |

Installed Structure

<ai-config-dir>/odoo19-module-development/
├── SKILL.md              # Main skill (loaded automatically)
└── references/           # 18 deep-dive API guides
    ├── odoo-19-actions.md
    ├── odoo-19-controller.md
    ├── odoo-19-data.md
    ├── odoo-19-decorator.md
    ├── odoo-19-development.md
    ├── odoo-19-field.md
    ├── odoo-19-manifest.md
    ├── odoo-19-migration.md
    ├── odoo-19-mixins.md
    ├── odoo-19-model.md
    ├── odoo-19-owl.md
    ├── odoo-19-performance.md
    ├── odoo-19-reports.md
    ├── odoo-19-security.md
    ├── odoo-19-testing.md
    ├── odoo-19-transaction.md
    ├── odoo-19-translation.md
    └── odoo-19-view.md

Usage

Just work on Odoo 19 code. The skill triggers automatically when your AI detects:

• Any .py or .xml in an Odoo addons directory
• __manifest__.py edits
• ir.model.access.csv files
• Security groups, mail.thread, OWL components
• Mentions of "Odoo 19" in conversation

Custom UI (HTML/JS/CSS dashboards)

When building dashboards or rich interactive UIs, the skill guides you to use OWL components + QWeb templates + SCSS instead of standard Odoo XML views, with design system generation via ui-ux-pro-max.

Server Access

Provide server credentials (e.g. [email protected]) and the AI will SSH in to inspect logs, config, service status — automatically, no confirmation needed.

Deploy is opt-in only. The AI will never deploy, restart, or modify the server unless you explicitly ask.

Release (for maintainers)

# 1. Bump version in package.json
# 2. Commit and tag
git add -A && git commit -m "release: v1.0.1"
git tag v1.0.1
git push origin main --tags
# 3. GitHub Actions CD will auto-publish to npm

Requires NPM_TOKEN secret in GitHub repo settings.

License

MIT