odoo-16 — Claude Code skill: what it does, how to install
Skill for Claude Code helps build and debug Odoo 16 projects and custom addons, covering Python ORM, XML, OWL, reports, and security. It activates around tracebacks, view errors, and model work.
MIT 112 installs ★ 152 updated 2026-10-22
npx skills add unclecatvn/agent-skills --skill odoo-16 -a claude-codeWhat odoo-16 does
The skill provides a development reference for Odoo 16 and custom addons. It covers Python models and ORM queries, XML and CSV data, views, OWL and JavaScript client code, QWeb reports, access control, record rules, scheduled jobs, migrations, tests, translations, and performance. HTTP controllers and CSS/SCSS assets are included too.
SKILL.md acts as a master index for guides in references/, with separate material for models, fields, manifests, actions, views, reports, security, transactions, and other Odoo topics. The skill applies when a task includes a traceback, addons/, __manifest__.py, form/tree/kanban or XML errors, HTTP controllers, or model business rules. Its guidance recommends running odoo-workflow before coding when that skill is installed; conflicting advice gives priority to Odoo 16 runtime behavior.
What it helps with
- debug an Odoo 16 traceback
- write ORM queries with domains
- fix XML views and QWeb reports
- configure ACLs, record rules, and groups
- migrate or upgrade an addon
Example prompts for the agent
- Trace this error in the addon under
addons/and explain the failing Odoo 16 code. - Add a computed field to the Python model and update
__manifest__.py. - Fix the form/tree/kanban XML view error and check its access rules.
How to install odoo-16
1Skills CLI (Vercel)
npx skills add unclecatvn/agent-skills --skill odoo-16 -a claude-code2Manually: put the files in place
~/.claude/skills/odoo-16.0/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/odoo-16.0/
1Skills CLI (Vercel)
npx skills add unclecatvn/agent-skills --skill odoo-16 -a codex2Manually: put the files in place
.agents/skills/odoo-16.0/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add unclecatvn/agent-skills --skill odoo-16 -a cursor2Manually: put the files in place
.cursor/skills/odoo-16.0/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install unclecatvn/agent-skills skills/odoo-16.02Manually: put the files in place
.github/skills/odoo-16.0/SKILL.md1Skills CLI (Vercel)
npx skills add unclecatvn/agent-skills --skill odoo-16 -a gemini-cli2Platform CLI
gemini skills install https://github.com/unclecatvn/agent-skills --path skills/odoo-16.0Manually: put the files in place
.devin/skills/odoo-16.0/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add unclecatvn/agent-skills --skill odoo-16 -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about odoo-16
How do I install odoo-16 in Claude Code?
Run npx skills add unclecatvn/agent-skills --skill odoo-16 -a claude-code, then use ~/.claude/skills/odoo-16.0/SKILL.md.
What does odoo-16 do?
It supplies Odoo 16 development guides for Python ORM, models, XML and views, OWL/JS, QWeb, security, testing, migrations, and performance. It applies to custom addon work, tracebacks, and interface errors.
When does the odoo-16 skill activate?
It is used for Odoo 16 or custom addon tasks, including tracebacks, addons/, __manifest__.py, form/tree/kanban or XML errors, HTTP controllers, and model business rules.
Source text
SKILL.md · MIT
---
name: odoo-16
description: >
Odoo 16 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 16 or custom addons—even if the user only pastes a traceback,
mentions addons/ or __manifest__.py, describes form/tree/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.
---
# Odoo 16 Skill - Master Index
Master index for all Odoo 16 development guides. Read the appropriate guide from `references/` based on your task.
## Quick Reference
| Topic | File | When to Use |
|-------|------|-------------|
| Actions | `references/odoo-16-actions-guide.md` | Creating actions, menus, scheduled jobs, server actions |
| API Decorators | `references/odoo-16-decorator-guide.md` | Using @api decorators, compute fields, validation |
| Controllers | `references/odoo-16-controller-guide.md` | Writing HTTP endpoints, routes, web controllers |
| Data Files | `references/odoo-16-data-guide.md` | XML/CSV data files, records, shortcuts |
| Development | `references/odoo-16-development-guide.md` | Creating modules, manifest, reports, security, wizards |
| Field Types | `references/odoo-16-field-guide.md` | Defining model fields, choosing field types |
| Manifest | `references/odoo-16-manifest-guide.md` | __manifest__.py configuration, dependencies, hooks |
| Migration | `references/odoo-16-migration-guide.md` | Upgrading modules, data migration, version changes |
| Mixins | `references/odoo-16-mixins-guide.md` | mail.thread, activities, email aliases, tracking |
| Model Methods | `references/odoo-16-model-guide.md` | Writing ORM queries, CRUD operations, domain filters |
| OWL Components | `references/odoo-16-owl-guide.md` | Building OWL UI components, hooks, services |
| Performance | `references/odoo-16-performance-guide.md` | Optimizing queries, fixing slow code, preventing N+1 |
| Reports | `references/odoo-16-reports-guide.md` | QWeb reports, PDF/HTML, templates, paper formats |
| Security | `references/odoo-16-security-guide.md` | Access rights, record rules, field permissions |
| Testing | `references/odoo-16-testing-guide.md` | Writing tests, mocking, assertions, browser testing |
| Transactions | `references/odoo-16-transaction-guide.md` | Handling database errors, savepoints, UniqueViolation |
| Translation | `references/odoo-16-translation-guide.md` | Adding translations, localization, i18n |
| Views & XML | `references/odoo-16-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 "Wrong:" items are what not to use in Odoo 16.
Apply the relevant convention section in the guide you open. The conventions
are advisory: preserve the style of an existing stable addon and keep diffs
focused. When guidance conflicts, prefer Odoo 16 runtime/source behavior,
then the surrounding addon style, then the convention.
- Module layout and asset placement: development and controller guides.
- XML formatting and external IDs: data, view, action, report, and security guides.
- Python naming, imports, recordsets, transactions, and translations: model,
field, decorator, performance, transaction, and translation guides.
- JavaScript and CSS/SCSS: development guide.
## File Structure
```
skills/odoo-16.0/
├── SKILL.md # This file - master index
└── references/ # Development guides
├── odoo-16-actions-guide.md
├── odoo-16-controller-guide.md
├── odoo-16-data-guide.md
├── odoo-16-decorator-guide.md
├── odoo-16-development-guide.md
├── odoo-16-field-guide.md
├── odoo-16-manifest-guide.md
├── odoo-16-migration-guide.md
├── odoo-16-mixins-guide.md
├── odoo-16-model-guide.md
├── odoo-16-owl-guide.md
├── odoo-16-performance-guide.md
├── odoo-16-reports-guide.md
├── odoo-16-security-guide.md
├── odoo-16-testing-guide.md
├── odoo-16-transaction-guide.md
├── odoo-16-translation-guide.md
└── odoo-16-view-guide.md
```
## Base Code Reference (Odoo 16)
All guides are based on analysis of Odoo 16 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
- [Odoo 16 Official Documentation](https://github.com/odoo/documentation/tree/16.0)
- [Odoo 16 Developer Reference](https://github.com/odoo/documentation/blob/16.0/content/developer/reference/backend/orm.rst)
- [Odoo 16 Coding Guidelines](https://github.com/odoo/documentation/blob/16.0/content/contributing/development/coding_guidelines.rst)
© unclecatvn · MIT · unclecatvn/agent-skills