pi-odoo-workflow

Odoo 18/19 development workflow for pi coding agent — eliminates repetitive instructions, enforces quality automatically, and adds /slash commands for common tasks.

What it does

🧠 Skill: workflow-odoo19

Loaded automatically when working on Odoo code. Claude will — without being asked:

• Ask for version once (18 or 19) and remember it for the session
• Check module structure before and after every change
• Write tests for every new method or feature
• Update tests when modifying existing code
• Check translations — all user-visible strings use _()
• Explain decisions before writing code, naming alternatives
• Suggest better patterns when they exist

Reference guides included: | File | Content | |------|---------| | module-structure.md | OCA-compatible directory layout, naming conventions | | v18-changes.md | v17 → v18 breaking changes with before/after code | | v19-changes.md | v18 → v19 breaking changes with before/after code | | testing-patterns.md | @tagged, setUpClass, wizard tests, exception tests | | translations.md | _() usage, .pot generation, common mistakes | | owl-patterns.md | patch(), custom field widgets, services, asset declaration |

⚡ Prompt Templates

Type /command in pi to expand into full instructions:

| Command | What it generates | |---------|------------------| | /odoo-module <name> | Complete module scaffold: dirs, manifest, __init__.py, security CSV, i18n, tests | | /odoo-model <model.name> | Full model: Python + form/list views + security + tests + manifest update | | /odoo-wizard <name> | TransientModel wizard: Python + dialog view + trigger button + tests | | /odoo-report <name> | QWeb PDF report: action + template + paper format + Print menu binding | | /odoo-inherit <view_xml_id> | View inheritance with correct XPath for 8 change types | | /odoo-cron <name> | Scheduled action: Python method + ir.cron XML + manifest update | | /odoo-test | Scans existing code and generates/updates tests for uncovered methods | | /odoo-review | Full audit: structure, APIs, translations, tests, security — with ✅/⚠️/❌ | | /odoo-migrate | Migrates module between versions (v17→v18 or v18→v19) | | /odoo-qa | QA tester — validates implementation against spec, generates functional summary and APPROVED/REJECTED verdict |

Install

# Con npx (recomendado — compatible con pi y Claude Code)
npx skills add EdgarNaranjo/agent-skills@workflow-odoo19 -g -y

# Con pi desde npm
pi install npm:pi-odoo-workflow

# Con pi desde GitHub
pi install git:github.com/EdgarNaranjo/agent-skills

# Probar sin instalar
pi -e git:github.com/EdgarNaranjo/agent-skills@workflow-odoo19

What makes this different

Every other Odoo skill for AI agents is a reference — it tells Claude how Odoo works. This skill tells Claude how to behave: what to do automatically, what to check, what to generate, and why.

The prompt templates are unique — no other Odoo skill package has /slash commands.

Compatible with

• pi coding agent
• Claude Code (npx skills add)
• Odoo 18 and 19

Works well alongside

• unclecatvn/[email protected] — deep API reference for Odoo 19
• alessandrorlm/[email protected] — reference for v17 patterns

License

LGPL-3.0-or-later — same license as Odoo Community modules.

Extensions (auto-loaded)

Two TypeScript extensions that run automatically — no commands needed:

🐍 Odoo Context Injector (odoo-context.ts)

When you open pi in a directory containing Odoo modules, it:

1. Detects all __manifest__.py files
2. Extracts module name, version, dependencies, models, inherited models, and view XML IDs
3. Notifies you: "🐍 Odoo: my_module (v19.0.1.0.0)"
4. Injects that context into Claude's system prompt automatically

Claude then knows exactly which models exist, which views can be inherited, and which XML IDs are available — without you having to explain anything.

Tool available to Claude: odoo_scan — returns the full module structure on demand.

🔍 Odoo XML-ID Finder (odoo-xmlid.ts)

Tool available to Claude: odoo_find_xmlid — finds the exact XML ID for any view, action, or record.

Searches in order:

1. Local Odoo source (if found at ~/odoo, ~/src/odoo, etc.) — instant grep
2. GitHub API (odoo/odoo repository) — fallback with direct raw file links

Links

• npm: pi-odoo-workflow
• GitHub: EdgarNaranjo/agent-skills
• pi.dev: pi-odoo-workflow
• Changelog: CHANGELOG.md