@marcfargas/odoo-skills
v0.5.2
Published
Battle-tested Odoo knowledge modules for AI agents — 5,200+ lines validated against Odoo v17 in CI
Maintainers
Readme
@marcfargas/odoo-skills
Battle-tested Odoo knowledge modules for AI agents — 5,200+ lines validated against Odoo v17 in CI.
What is this?
Ready-to-use knowledge that teaches AI agents (Claude Code, Cursor, etc.) how to work with Odoo ERP. Each module covers a specific topic with tested code examples.
Installation
As a pi skill (recommended for agents)
pi install npm:@marcfargas/odoo-skillsAs an npm package
npm install @marcfargas/odoo-skillsThen point your AI agent to the skill files in node_modules/@marcfargas/odoo-skills/skills/.
Or use the scaffolding CLI for a standalone project:
npx @marcfargas/create-odoo-skills my-odoo-skillsModules
| Module | What it teaches | |--------|-----------------| | SKILL.md | Start here — router and quick start | | connection | Authentication and session management | | field-types | Odoo type system and read/write asymmetry | | domains | Query filter syntax and composition | | crud | Create, Read, Update, Delete operations | | search | Search and filtering patterns | | introspection | Discover models and fields dynamically | | properties | Dynamic user-defined fields | | modules | Module lifecycle management | | skill-generation | How to create new skills |
Mail System
| Module | What it teaches | |--------|-----------------| | chatter | Internal notes and public messages | | activities | Activity scheduling and management | | discuss | Channels and direct messaging |
Module-Specific
| Module | Required Odoo Modules | What it teaches |
|--------|----------------------|-----------------|
| accounting | account | Accounting patterns, cash discovery, reconciliation, PnL, validation |
| attendance | hr_attendance | Clock in/out, presence tracking |
| contracts | contract (OCA) | Recurring contracts, billing schedules, revenue projection |
| timesheets | hr_timesheet | Time tracking on projects |
| mis-builder | mis_builder | OCA financial reports (reading, computing, exporting) |
| mis-builder-dev | mis_builder | OCA financial reports (creating, editing, expression language) |
Prerequisites
- Node.js ≥ 18 (for the
@marcfargas/odoo-clientlibrary used in examples) - Odoo v17 instance
Related Packages
- @marcfargas/odoo-client — RPC client used in all examples
- @marcfargas/odoo-introspection — Schema discovery
- @marcfargas/create-odoo-skills — Scaffold a skill project
Bugs & Support
License
CC0 1.0 Universal — public domain. Use the knowledge freely in any project, commercial or not, with no attribution required.
