Skip to content

Latest commit

 

History

History

README.md

Agent Skills for odoo-mcp

skills.sh

Business-workflow playbooks that pair with the odoo-mcp server — the MCP + Skills hybrid: MCP provides the safe tool layer (gated writes, field ACL, bounded reads), these skills provide the judgment layer (pacing, evidence rules, human checkpoints). They follow the open Agent Skills format (SKILL.md with YAML frontmatter) supported by Claude Code, Codex, Cursor, Gemini CLI, and other skills-compatible agents.

Skill What it drives Key odoo-mcp tools
odoo-data-quality-gate Evidence-first data audit + gated remediation data_quality_report, diagnose_access, write gate
odoo-migration-copilot Version-upgrade worklist (16→19/20), log triage, JSON-2 prep scan_addons_source, analyze_upgrade_log, upgrade_risk_report, lookup_model_history, generate_json2_payload
odoo-month-end-close Month-end close with human sign-off per posting accounting_health_summary, receivable_payable_aging, aggregate_records, write gate, chatter_post
odoo-agency-fleet-review Multi-client fleet status for agencies/partners list_instances, *_across_instances, async tasks

Install

One command, any skills-compatible agent (Claude Code, Codex, Gemini CLI, GitHub Copilot, OpenCode, Warp, …):

npx skills add erpipe-org/mcp-odoo

Or manually for Claude Code:

git clone https://github.com/erpipe-org/mcp-odoo
cp -r mcp-odoo/skills/odoo-* ~/.claude/skills/

Then make sure the odoo-mcp server itself is connected (uvx odoo-mcp --setup prints the snippet). Invoke naturally ("check data quality before our migration") or explicitly (/odoo-data-quality-gate).

Design rules these skills follow

  • Every number shown to the human comes from a tool result — no guessed figures.
  • Writes only through preview_writevalidate_writeexecute_approved_write, one approved batch at a time.
  • redacted_fields and cross-instance opt-outs are policy, never errors to work around.

Companion pack: the developer suite

These four skills are operator/consultant workflows — they need nothing but Odoo credentials. If you're developing on Odoo (custom addons, OWL, views, tests, performance) and have shell access to the instance, install the companion developer suite — 21 skills built around reading ground truth from the running registry (field inventory, MRO/super chains, view wiring, runtime traces) before writing any code:

npx skills add tuanle96/odoo-ai-skills

The two packs are designed together: odoo-ai-skills uses odoo-mcp as its RPC fallback when there's no shell (Odoo Online/SaaS), and both route every write through a human gate.

Want a skill for your vertical? They're plain Markdown — PRs welcome (see CONTRIBUTING.md), or ship your own alongside a tool plugin.