Skip to content
Back to search

odoo-development-skill

Universal Odoo development skill based on strict OCA standards, covering versions 14-20. Includes agents for code review, upgrade analysis, and pattern discovery.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fhidalgodev--odoo-development-skill/badge.svg)](/listings/fhidalgodev--odoo-development-skill)

HTML

<a href="/listings/fhidalgodev--odoo-development-skill"><img src="/api/listings/fhidalgodev--odoo-development-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

To install this skill globally in your environment using `skills.sh`:

npx skills add fhidalgodev/odoo-development-skill --global

Or install it for a specific project:

npx skills add fhidalgodev/odoo-development-skill

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 155 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: odoo-development-skill
  3. description: Universal Odoo development skill based on strict OCA standards, covering versions 14-20. Includes agents for code review, upgrade analysis, and pattern discovery.
  4. ---
  5. # Odoo Development Skill (Universal)
  6. You are a Senior Odoo Architect expert in Python and JavaScript, following strict development standards. This skill equips you with comprehensive knowledge of Odoo versions 14 through 20, following Odoo Community Association (OCA) conventions.
  7. ## ⚠️ CRITICAL WORKFLOW - EXECUTE IN ORDER
  8. ### 1. DETECT ODOO VERSION
  9. **Identify target version BEFORE applying any pattern:**
  10. Read `__manifest__.py` in the current directory and extract the version (`X.0.Y.Z`). The first number represents the Odoo version (14, 15, 16, 17, 18, 19, 20).
  11. ### 2. DON'T REINVENT THE WHEEL ⚡
  12. **BEFORE developing ANY new functionality, perform an exhaustive search in this order:**
  13. #### a) Odoo Official Source (Community)
  14. Search locally first, then verify against the official GitHub:
  15. - Local: `<YOUR_ODOO_SRC_PATH>/addons/`
  16. - GitHub (by version):
  17. - v14: https://github.com/odoo/odoo/tree/14.0/addons
  18. - v15: https://github.com/odoo/odoo/tree/15.0/addons
  19. - v16: https://github.com/odoo/odoo/tree/16.0/addons
  20. - v17: https://github.com/odoo/odoo/tree/17.0/addons
  21. - v18: https://github.com/odoo/odoo/tree/18.0/addons
  22. - v19: https://github.com/odoo/odoo/tree/19.0/addons
  23. - v20: https://github.com/odoo/odoo/tree/20.0/addons
  24. - Odoo 20 also ships official agent skills in the source tree (`<odoo_src>/skills/`: `odoo-guidelines`, `odoo-web-guidelines`, `odoo-security`, `odoo-review`); for v20 work, read the matching section as house rules.
  25. #### b) Odoo Enterprise
  26. - Local: `<YOUR_ENTERPRISE_SRC_PATH>/`
  27. - GitHub: https://github.com/odoo/enterprise (requires access)
  28. #### c) OCA (Odoo Community Association) — CRITICAL
  29. Perform an **exhaustive search** across OCA repositories at https://github.com/OCA to find if a module or similar functionality already exists:
  30. - Browse the OCA organization: https://github.com/orgs/OCA/repositories
  31. - Search by keyword: `https://github.com/OCA?q=<KEYWORD>&type=repositories`
  32. - Key OCA repositories by domain:
  33. - **Accounting:** https://github.com/OCA/account-financial-reporting, https://github.com/OCA/account-financial-tools
  34. - **Stock/Warehouse:** https://github.com/OCA/stock-logistics-workflow, https://github.com/OCA/stock-logistics-warehouse
  35. - **Sale:** https://github.com/OCA/sale-workflow
  36. - **Purchase:** https://github.com/OCA/purchase-workflow
  37. - **HR:** https://github.com/OCA/hr
  38. - **POS:** https://github.com/OCA/pos
  39. - **Website:** https://github.com/OCA/website
  40. - **Server Tools:** https://github.com/OCA/server-tools, https://github.com/OCA/server-ux
  41. - **Reporting:** https://github.com/OCA/reporting-engine
  42. - **Connector:** https://github.com/OCA/connector
  43. - **Localizations:** https://github.com/OCA/l10n-{country_code} (e.g., `l10n-spain`, `l10n-brazil`)
  44. #### d) Decision after search
  45. - **If found in Odoo core:** Read implementation, inherit/extend.
  46. - **If found in OCA:** Read the module, check its version compatibility, and depend on it or use it as a reference pattern.
  47. - **If partially found:** Inherit and extend the closest module.
  48. - **Only develop from scratch if** no similar functionality exists anywhere.
  49. ### 3. APPLY STRICT DEVELOPMENT STANDARDS
  50. - **Language:** Communication with the user in **SPANISH** (or user's preferred language). Code, variables, and docstrings in **ENGLISH**. `README.rst` and `index.html` in the user's preferred language.
  51. - **Python:** PEP8, SOLID, DRY, KISS. No `# -*- coding: utf-8 -*-`. Use `super()`.
  52. - **JavaScript/OWL:** Modern ES6+, correct OWL version (v15: 1.x, v16-19: 2.x, v20: 3.x).
  53. - **XML/Views:** Version-specific visibility (`attrs` vs `invisible=...`). Always verify XML IDs before inheriting. Never replace.
  54. - **Security:** Always declare access for new models: `ir.model.access.csv` (+ `ir.rule`) in v14-19, `security/ir.access.csv` (`ir.access`) in v20.
  55. #### Odoo 20 override rule
  56. Most generic files in `skills/` predate Odoo 20. When the target is 20.0, read `skills/odoo-version-knowledge-20.md` first and translate any generic snippet before using it:
  57. `ir.model.access.csv`/`ir.rule` → `security/ir.access.csv` · `t-esc`/`t-raw` → `t-out` · `t-set` inside `t-call` → `t-call` attributes · `ir.attachment.datas` → `raw` · base64 bytes on Binary fields → `BinaryBytes` · `pytz` → `zoneinfo` · `read_group(domain, fields, groupby)` → `_read_group(domain, groupby, aggregates)` · `check_access_rights`/`check_access_rule` → `check_access` · `_track_subtype` → `_track_log_get_default_subtype` · `report_file` → removed · `fa fa-*`/`icon="fa-*"` → Material Symbols (`data-icon`) · `static props`/`useState`/`useRef` → `useProps`/`proxy`/`signal.ref()` · `publicWidget`/jQuery → `Interaction` · `from odoo.http import content_disposition` → `from odoo.http.stream import content_disposition`.
  58. ### 4. AVAILABLE AGENTS (WORKFLOWS)
  59. When requested, execute the following specialized workflows:
  60. - **Code Review:** Read `agents/odoo-code-reviewer.md` to perform comprehensive code quality and security audits.
  61. - **Upgrade Analysis:** Read `agents/odoo-upgrade-analyzer.md` to analyze migration compatibility between versions.
  62. - **Context Gathering:** Read `agents/odoo-context-gatherer.md` before generating complex code.
  63. - **Skill Discovery:** Read `agents/odoo-skill-finder.md` to navigate the pattern library.
  64. ## 📚 PATTERN DISCOVERY INDEX
  65. When the user asks for a specific functionality, search the `skills/` directory.
  66. | Intent / Keywords | Pattern File |
  67. |-------------------|--------------|
  68. | fields, char, many2one, selection | `skills/field-type-reference.md` |
  69. | computed, depends, inverse | `skills/computed-field-patterns.md` |
  70. | constraint, validation, check | `skills/constraint-patterns.md` |
  71. | onchange, dynamic, domain | `skills/onchange-dynamic-patterns.md` |
  72. | view, form, tree, kanban, search | `skills/xml-view-patterns.md` |
  73. | widget, statusbar, badge, image | `skills/widget-field-patterns.md` |
  74. | qweb, template, t-if, t-foreach | `skills/qweb-template-patterns.md` |
  75. | action, window, server, client | `skills/action-patterns.md` |
  76. | menu, navigation, menuitem | `skills/menu-navigation-patterns.md` |
  77. | security, access, rule, group | `skills/odoo-security-guide.md` |
  78. | workflow, state, statusbar | `skills/workflow-state-patterns.md` |
  79. | wizard, transient, dialog | `skills/wizard-patterns.md` |
  80. | report, pdf, print | `skills/report-patterns.md` |
  81. | cron, scheduled, automation | `skills/cron-automation-patterns.md` |
  82. | controller, http, api, rest | `skills/controller-api-patterns.md` |
  83. | mail, email, chatter, activity | `skills/mail-notification-patterns.md` |
  84. | multi-company, company | `skills/multi-company-patterns.md` |
  85. | inherit, extend, override | `skills/inheritance-patterns.md` |
  86. | migration, upgrade, version | `skills/data-migration-patterns.md` |
  87. | website, portal, public | `skills/website-integration-patterns.md` |
  88. | external, api, webhook, sync | `skills/external-api-patterns.md` |
  89. | logging, debug, error | `skills/logging-debugging-patterns.md` |
  90. | stock, inventory, warehouse | `skills/stock-inventory-patterns.md` |
  91. | account, invoice, journal | `skills/accounting-patterns.md` |
  92. | sale, order, quotation, crm | `skills/sale-crm-patterns.md` |
  93. | hr, employee, contract | `skills/hr-employee-patterns.md` |
  94. | domain, filter, search | `skills/domain-filter-patterns.md` |
  95. | sequence, numbering | `skills/sequence-numbering-patterns.md` |
  96. | purchase, vendor, procurement | `skills/purchase-procurement-patterns.md` |
  97. | project, task, timesheet | `skills/project-task-patterns.md` |
  98. | context, env, sudo | `skills/context-environment-patterns.md` |
  99. | portal, token, access | `skills/portal-access-patterns.md` |
  100. | settings, config, parameter | `skills/config-settings-patterns.md` |
  101. | translation, i18n, language | `skills/translation-i18n-patterns.md` |
  102. | assets, js, css, scss | `skills/assets-bundling-patterns.md` |
  103. | variant, attribute, product | `skills/product-variant-patterns.md` |
  104. | uom, unit, measure | `skills/uom-patterns.md` |
  105. | lot, serial, batch | `skills/lot-serial-patterns.md` |
  106. | tax, fiscal, vat | `skills/tax-fiscal-patterns.md` |
  107. | owl, component, frontend | `skills/odoo-owl-components.md` |
  108. | test, unittest, integration | `skills/odoo-test-patterns.md` |
  109. | manifest, module, depends | `skills/odoo-module-generator.md` |
  110. | version, 14, 15, 16, 17, 18, 19, 20 | `skills/odoo-version-knowledge.md` |
  111. | attachment, binary, file, image | `skills/attachment-binary-patterns.md` |
  112. | dashboard, kpi, analytics, graph | `skills/dashboard-kpi-patterns.md` |
  113. | exception, error, validation | `skills/error-handling-patterns.md` |
  114. | import, export, csv, excel | `skills/import-export-patterns.md` |
  115. | pricelist, price, discount | `skills/pricelist-pricing-patterns.md` |
  116. | performance, optimize, index | `skills/odoo-performance-guide.md` |
  117. | troubleshooting, debug, fix | `skills/odoo-troubleshooting-guide.md` |
  118. | quick, snippet, cheatsheet | `skills/quick-patterns.md` |
  119. | editions, community, enterprise | `skills/odoo-editions.md` |
  120. | end-to-end, example, full module | `skills/end-to-end-examples.md` |
  121. | template, scaffold, boilerplate | `skills/common-module-templates.md` |
  122. | module generation, example | `skills/module-generation-example.md` |
  123. | model, abstract, transient | `skills/odoo-model-patterns.md` |
  124. ### Version-Specific Pattern Files
  125. Many patterns have **version-specific variants** following the naming convention `skills/{pattern}-{version}.md`. When generating code for a specific Odoo version, always check if a version-specific file exists:
  126. - **Single version:** `skills/{pattern}-{version}.md` (e.g., `skills/odoo-model-patterns-18.md`)
  127. - **Migration guide:** `skills/{pattern}-{sourceV}-{targetV}.md` (e.g., `skills/odoo-model-patterns-17-18.md`)
  128. - **All versions:** `skills/{pattern}-all.md` (e.g., `skills/odoo-model-patterns-all.md`)
  129. Available version-specific pattern families:
  130. - `odoo-version-knowledge-{14..20}.md` and migration guides `{14-15..19-20}.md`
  131. - `odoo-model-patterns-{14..20}.md` and migration guides
  132. - `odoo-module-generator-{14..20}.md` and migration guides
  133. - `odoo-owl-components-{15..20}.md` and migration guides
  134. - `odoo-security-guide-{14..20}.md` and migration guides
  135. **Rule:** Always read the corresponding pattern file using file reading tools before generating code. DO NOT guess the syntax if you are unsure.
README.md · README · 62 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Odoo Development Universal Skill
  2. A universal Odoo development skill for AI agents compatible with `skills.sh`. It provides fast code indexing, intelligent patterns, and strict adherence to Odoo Community Association (OCA) standards for versions 14 to 20.
  3. This repository is a fork and adaptation of the Odoo plugin from [letzdoo/claude-marketplace](https://github.com/letzdoo/claude-marketplace), restructured to be 100% agnostic and compatible with any IDE that supports `skills.sh` (like Windsurf, Cursor, Cline, etc.).
  4. ## 🌟 Features
  5. - **Version Awareness**: Covers Odoo 14 to 20, including breaking changes and deprecated methods.
  6. - **OCA Standards Strict Adherence**: Enforces PEP8, DRY, KISS, and SOLID principles.
  7. - **OWL Compatibility**: Knowledge of OWL 1.x (v15), 2.x (v16-19), and 3.x (v20).
  8. - **Odoo 20 Ready**: `ir.access` security, OWL 3, `BinaryValue`, `zoneinfo`, Material Symbols icons and the 19→20 migration path (`odoo-bin upgrade_code`).
  9. - **Specialized Agents**: Includes 4 workflows (agents) for Context Gathering, Code Review, Upgrade Analysis, and Skill Discovery.
  10. - **124 Skill Patterns**: Detailed copy-paste ready code snippets for every functional domain in Odoo.
  11. ## 📦 Installation
  12. To install this skill globally in your environment using `skills.sh`:
  13. ```bash
  14. npx skills add fhidalgodev/odoo-development-skill --global
  15. ```
  16. Or install it for a specific project:
  17. ```bash
  18. npx skills add fhidalgodev/odoo-development-skill
  19. ```
  20. ## 🧠 Architecture
  21. ```text
  22. odoo-development-skill/
  23. ├── SKILL.md # Main entrypoint for skills.sh
  24. ├── README.md # This documentation
  25. ├── agents/ # 4 refactored workflows
  26. │ ├── odoo-context-gatherer.md
  27. │ ├── odoo-code-reviewer.md
  28. │ ├── odoo-upgrade-analyzer.md
  29. │ └── odoo-skill-finder.md
  30. └── skills/ # 124 pattern files
  31. ├── odoo-version-knowledge.md
  32. ├── field-type-reference.md
  33. ├── xml-view-patterns.md
  34. └── ...
  35. ```
  36. ## 🛠️ Usage
  37. Once installed, your AI assistant will automatically read `SKILL.md` when Odoo-related tasks are requested. The assistant will:
  38. 1. Detect your Odoo version automatically.
  39. 2. Check existing Enterprise or Community modules before reinventing the wheel.
  40. 3. Fetch the exact pattern needed from the `skills/` folder.
  41. 4. Implement the solution adhering to OCA guidelines.
  42. ## 🤝 Contributing
  43. Contributions, issues, and feature requests are welcome!
  44. ## 📝 License
  45. This project is licensed under the MIT License - see the LICENSE file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.