@marcfargas/odoo-skills
Battle-tested Odoo knowledge modules for AI agents — 5,200+ lines validated against Odoo v17 in CI
Package details
Install @marcfargas/odoo-skills from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@marcfargas/odoo-skills- Package
@marcfargas/odoo-skills- Version
0.5.3- Published
- Mar 13, 2026
- Downloads
- 74/mo · 39/wk
- Author
- marcfargas
- License
- CC0-1.0
- Types
- skill
- Size
- 251.5 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"skills": [
"./skills"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
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-skills
As an npm package
npm install @marcfargas/odoo-skills
Then 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-skills
Modules
| 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.