unclecatvn/agent-skills / skills/odoo-workflow
odoo-workflow
UnverifiedMandatory pre-code gate and definition-of-done for ANY Odoo change (add field, override method, inherit view/xpath, OWL/JS patch, wizard, cron, controller, report, security, migration, bug fix, refactor, "optimize", "clean code", "stick to base"), Odoo 16-19. Also when the user pastes an Odoo traceback or install/upgrade error (ParseError "cannot be located in parent view", "Field ... does not exist", missing xmlid) or asks where an Odoo model, field, method, view or xmlid is defined. Run BEFORE brainstorming or planning: Odoo design questions are answered by tracing the real source into a Context Brief (file:line), not by open-ended Q&A or memory. Resolves the Odoo runtime and version, loads the matching odoo-<major> pack, and closes with install, test, upgrade, i18n, security and hygiene checks before commit.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.3 KB |
| references/definition-of-done.md | markdown | 8.2 KB |
| scripts/odoo_trace.py | script | 67.4 KB |
| templates/CLAUDE.md | markdown | 1.7 KB |
templates/CLAUDE.md
View on GitHub# Odoo project rules
<!-- Merge into the project's CLAUDE.md (and AGENTS.md for other agents). Adjust version and layout. -->
Odoo version: **18.0**. Addons roots, in `addons_path` order: `erp`, `erp-external`,
`erp-internal` (Enterprise). Each is its own git repository.
Machine-local runtime lives in `.claude/odoo.json` (gitignored), read by the `odoo-workflow`
helper:
```json
{"odoo_version": "18.0", "odoo_root": "/path/to/odoo/18.0", "conf": "/path/to/odoo/18.0/odoo.conf",
"python": "/path/to/odoo/18.0/.venv/bin/python3", "dev_db": "v18_dev"}
```
## Every Odoo change
- Run the `odoo-workflow` skill first - before brainstorming or planning skills, which start
from its Context Brief - then the Odoo 18 pack for the guide you need.
No code without a Context Brief that cites `file:line` in the real source.
- Throwaway databases only (`scratch_*`, `upg_*`). Never install or upgrade modules on
`v18_dev`, staging, or a customer copy unless asked by name.
- Stored-field renames, removals, and type or selection-key changes ship with a manifest version
bump and a `migrations/<version>/` script.
- Bind `sudo()` results to `<name>_sudo`; never return them from public methods.
- Strings changed: regenerate `i18n/<module>.pot` and merge every `.po` (file names unchanged)
before commit.
## Never
- `ponytail:` or "simplified for now" comments in this repo.
- `Co-Authored-By`, `Generated with`, or session links in commits or PR bodies.
Disable them at the source once with the Claude Code `attribution` setting
(`{"commit": "", "pr": ""}`, project or user level - see the agent-skills README).
## Commits
- Use the `odoo-commit` skill: `[TAG] module: description`, one module per commit, one commit
and PR per repository.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |