vodoo_skill

Overview

This skill provides a CLI for querying and managing Odoo ERP data via the vodoo command set. It exposes focused modules for helpdesk tickets, projects, tasks, CRM leads, knowledge articles, generic models, and security operations. It is designed for fast, scriptable interactions with Odoo through XML-RPC.

How this skill works

The vodoo CLI runs commands via UVX and communicates with Odoo using XML-RPC to read, create, update, delete, and call methods on records. Modules map to common Odoo models (helpdesk.ticket, project.task, crm.lead, knowledge.article, etc.). Most commands support options like --limit and require --no-color to avoid ANSI codes and reduce token usage.

When to use it

• Perform bulk queries and scripted updates against Odoo from the terminal or CI pipelines
• Review or update support tickets, project tasks, projects, CRM leads, and knowledge articles quickly
• Automate export/import or backups of specific records using the generic model commands
• Manage API/service accounts and user groups for programmatic access
• Debug or inspect field values, attachments, and chatter history for records

Best practices

• Always include --no-color immediately after vodoo to disable ANSI escape codes and reduce token usage
• Run fields or list commands first to discover available fields and valid stage names
• Use --limit when listing records to avoid large result sets
• Prefer the model read/create/update/delete commands when working with non-standard models
• Use tag-create and tag-delete carefully to maintain tagging consistency

Example use cases

• List recent helpdesk tickets in a specific stage and add an internal note to escalate priority
• Create and assign a project task from a CI job after a failing test report
• Update expected_revenue on a CRM lead and attach the proposal PDF
• Download all attachments for a helpdesk ticket to archive customer files
• Create a service user and assign it to Vodoo API groups for automated integrations