Cómo instalar las skills oficiales de Odoo 20 en tu agente de IA
Odoo 20 incluye por primera vez cuatro skills oficiales: documentos con las reglas de desarrollo de Odoo escritos para que los lea una inteligencia artificial. Vienen dentro del código fuente y se instalan copiando una carpeta.
Las skills de Odoo están en la carpeta odoo/skills del repositorio,
en la rama 20.0 o master. Para instalarlas, copia las cuatro a
~/.claude/skills/ si usas Claude Code, o a
~/.agents/skills/
si usas OpenCode o Codex, y reinicia la sesión del agente. No hay que configurar
nada más: el agente las carga por su cuenta cuando le pides una revisión de
código.
Ojo, que esto acaba de nacer. Las skills entraron en el código de Odoo el
27 de agosto de 2026, así que llevan semanas, no años. Lo normal es que Odoo siga
añadiendo reglas, quitando otras y moviendo cosas de sitio. Lo que cuento aquí es
lo que había a 21 de septiembre de 2026: antes de instalar, asómate al repositorio
oficial y mira qué hay hoy. Y si ya las tienes copiadas, repite el
cp -r de vez en cuando, porque no se actualizan solas.
Qué son las skills de Odoo
Una skill es un documento estructurado que un agente de inteligencia artificial lee antes de ponerse a trabajar. No es un plugin ni una configuración: son ficheros de texto con las reglas de la casa, escritos en un formato que el agente reconoce y carga solo cuando la tarea lo pide.
Esto importa porque un agente sin skills escribe Python que funciona y Odoo que
está mal. Se inventa un campo que no existe, mete un sudo donde no
toca, se salta las reglas de acceso o usa una API que Odoo retiró hace tres
versiones. Son errores que el código no revela hasta que ya está en producción.
Las skills de Odoo 20 cortan eso de raíz porque las escribe el propio equipo de
Odoo. Cubren estructura de módulos, manifest, ORM, campos, vistas XML, permisos,
rendimiento, tests, el framework web y la auditoría de seguridad. Son unas
novecientas líneas de reglas concretas, no de consejos generales: el fichero de
ORM dice, por ejemplo, que un método público es una puerta de entrada por RPC, o
que un
@api.depends tiene que listar todos los campos que lee el compute.
Cuáles son las cuatro skills de Odoo 20
Odoo 20 trae cuatro skills, y cada una cubre un terreno distinto del desarrollo de un módulo:
odoo-guidelines
Las reglas del código al escribir módulos Odoo, repartidas en trece ficheros: manifest, estructura del módulo, campos, ORM, Python, XML, controladores, rendimiento, tests, informes, comentarios, seguridad y versión estable. Es la más extensa.
odoo-security
La auditoría de seguridad: control de acceso, uso de sudo,
inyección SQL, dominios, XSS, controladores sin autenticar y métodos
públicos expuestos por RPC.
odoo-web-guidelines
(Frontend) Las reglas de la carpeta static/: JavaScript,
plantillas Owl y SCSS. Va aparte porque el framework web de Odoo tiene sus
propias convenciones.
odoo-review
Es la única que pides tú, la usas para revisar código o módulos de Odoo. Le pides que revise el código y le aplica la skill que corresponda.
Cómo instalar las skills de Odoo 20 paso a paso
La instalación consiste en copiar cuatro carpetas al sitio donde tu agente busca sus skills. Tarda un par de minutos y no requiere configurar nada.
⚠️ Antes de copiar y pegar: la ruta
~/odoo_dev/odoo20/odoo que verás en los comandos es la de mi
equipo. Cámbiala por la carpeta donde tengas tú Odoo, o los comandos te darán un
error de carpeta no encontrada. Las rutas de destino,
~/.claude/skills/ y ~/.agents/skills/, sí son iguales
para todo el mundo: esas se dejan tal cual.
Ten Odoo 20 clonado en tu equipo
Las skills viajan dentro del código fuente de Odoo, así que necesitas el repositorio clonado en la rama 20.0 o en master. Comprueba en qué rama estás:
cd ~/odoo_dev/odoo20/odoo && git branch --show-current
Si todavía no tienes el entorno montado, sigue antes la guía para instalar Odoo 20 en Ubuntu 26.04 y vuelve aquí.
Localiza la carpeta de skills
Están en odoo/skills, dentro del repositorio:
ls -R ~/odoo_dev/odoo20/odoo/skills
Verás las cuatro carpetas y un README.md. Cada skill lleva un
fichero SKILL.md con su descripción, y las dos de guidelines
traen además una subcarpeta con las reglas por tema.
Dónde busca las skills tu agente
Cada agente busca sus skills en su propia carpeta. La buena noticia es que
casi todos leen la misma, ~/.agents/skills/, así que con dos
carpetas cubres a casi todos:
| Agente | Carpeta personal | Carpeta del proyecto |
|---|---|---|
| Claude Code | ~/.claude/skills/ |
.claude/skills/ |
| Codex | ~/.agents/skills/ |
.agents/skills/ |
| Cursor | ~/.agents/skills/ |
.agents/skills/ |
| VS Code (Copilot) | ~/.agents/skills/ |
.agents/skills/ |
| OpenCode | ~/.agents/skills/ |
.agents/skills/ |
| Antigravity (CLI) | ~/.gemini/skills/ |
.agents/skills/ |
| Antigravity (IDE) | ~/.gemini/config/skills/ |
.agents/skills/ |
Antigravity es la excepción: a nivel de proyecto usa
.agents/skills/ como todos, pero no lee
~/.agents/skills/: las suyas cuelgan de
~/.gemini/. Su CLI te lista las tres rutas que mira, y en las
tres cada skill es una carpeta con su SKILL.md dentro:
Workspace: /.agents/skills//SKILL.md
Global: ~/.gemini/antigravity-cli/skills//SKILL.md
Shared: ~/.gemini/skills//SKILL.md
La de workspace vale solo dentro de ese proyecto (por ejemplo
~/odoo_dev/odoo19/.agents/skills/). La
global cuelga dentro de antigravity-cli/, que es la
casa de ese binario, así que es del CLI y de nadie más. La
compartida cuelga directa de ~/.gemini/, la raíz
común de las herramientas de Gemini, y es la que cubre más con una sola
copia: usa esa.
El IDE de Antigravity va por su cuenta y lee
~/.gemini/config/skills/ (la antigua
~/.gemini/antigravity/skills/ le sigue valiendo). Si usas CLI
e IDE, copia a las dos carpetas.
Varios admiten además rutas propias, por compatibilidad: Cursor lee
también
.cursor/skills/, VS Code .github/skills/ y
OpenCode .opencode/skills/. No hacen falta si usas las de la
tabla.
Si las pones en tu carpeta personal, como en los ejemplos, quedan disponibles en todos tus proyectos. Si prefieres tenerlas solo en uno, usa las mismas rutas pero en la raíz de ese proyecto.
Copia las cuatro skills
mkdir -p ~/.claude/skills ~/.agents/skills
cp -r ~/odoo_dev/odoo20/odoo/skills/* ~/.claude/skills/
cp -r ~/odoo_dev/odoo20/odoo/skills/* ~/.agents/skills/
Si además usas Antigravity, que no lee ~/.agents/skills/,
añade sus dos carpetas:
mkdir -p ~/.gemini/skills ~/.gemini/config/skills
cp -r ~/odoo_dev/odoo20/odoo/skills/* ~/.gemini/skills/
cp -r ~/odoo_dev/odoo20/odoo/skills/* ~/.gemini/config/skills/
El mkdir -p va primero porque si la carpeta de destino no
existe todavía, el cp falla con un error de fichero no
encontrado.
odoo-review porque es la que vas a usar, la llamas y se queda
a medias buscando a las otras tres.
Reinicia la sesión del agente
La mayoría de agentes leen las skills al arrancar la sesión, así que cierra la que tengas abierta y ábrela de nuevo. Codex es la excepción: detecta los ficheros nuevos sin reiniciar. Con esto ya están instaladas.
¿Prefieres que lo haga tu agente?
Si no te apetece picar los comandos, pégale esto tal cual al agente que ya tengas abierto. Cubre las dos rutas y se encarga de comprobar que quedó bien:
Instala las skills oficiales de Odoo 20 en mi equipo.
1. Localiza mi clon del repositorio de Odoo en la rama 20.0 o master.
Si no lo encuentras, pregúntame dónde está. No lo clones tú.
2. Comprueba que existe la carpeta skills dentro del repositorio.
3. Crea ~/.claude/skills y ~/.agents/skills si no existen, y copia en
cada una las cuatro carpetas de skills, sin borrar nada de lo que
ya haya dentro.
4. Lístame el contenido de las dos carpetas para confirmar.
5. Recuérdame que reinicie la sesión: eso no lo puedes hacer tú.
El último punto importa: ningún agente puede reiniciarse a sí mismo, así que ese paso te toca a ti igualmente.
Cómo comprobar que tu agente carga las skills
No hay nada que activar ni ningún comando que ejecutar. La comprobación es pedirle una revisión de código normal y mirar qué hace:
Revisa este módulo
En el registro de la sesión verás que el agente carga
odoo-review por su cuenta, y que esta a su vez tira de
odoo-guidelines y se pone a leer las reglas de manifest, de Python
y de ORM. Nadie se lo ha pedido: reconoce que el trabajo es de Odoo y va a
buscar las reglas antes de opinar sobre tu código.
Esa es la diferencia práctica. Sin skills, el agente revisa tu módulo con lo que recuerda de Odoo en general. Con skills, lo revisa contra el estándar que publica Odoo, que es el mismo con el que se revisa el código del propio producto.
Preguntas frecuentes
¿Las skills funcionan en Odoo 19 o en versiones anteriores?
Las skills solo están en el código fuente de Odoo 20 y de master. Ni Odoo 19 ni
Odoo 18 las incluyen. Dicho esto, las reglas que contienen son en su mayoría
convenciones de Odoo que llevan años vigentes, así que copiarlas y usarlas
mientras desarrollas para una versión anterior sigue siendo útil. Lo que no
puedes hacer es darlas por buenas al pie de la letra: alguna regla es específica
de la 20, como que el fichero de permisos pasó a llamarse
ir.access.csv.
¿Sirven para Claude Code, Codex, Cursor, Copilot y OpenCode a la vez?
Sí, y también para Antigravity de Google. Las skills usan el formato abierto
Agent Skills, que soportan Claude Code, Codex, Cursor, GitHub Copilot en VS Code,
OpenCode, Antigravity y bastantes más. Lo único que cambia es la carpeta donde
cada uno las busca, y casi todos leen la misma:
~/.agents/skills/. Por eso en la guía se copian a dos rutas. La
excepción es Antigravity, que no lee ~/.agents/skills/ y busca las
suyas bajo ~/.gemini/: ~/.gemini/skills/ en el CLI y
~/.gemini/config/skills/ en el IDE.
¿Hace falta instalar las cuatro?
Sí. Las skills se referencian entre sí y odoo-review delega el
trabajo en las otras tres. Instalar solo una deja el conjunto incompleto y la
revisión sale a medias.
¿Se actualizan solas?
No. Son ficheros que has copiado, así que se quedan como estaban el día que los
copiaste. Cuando hagas git pull del repositorio de Odoo, vuelve a
ejecutar el cp -r para llevarte la última versión de las reglas.
¿Es lo mismo que el MCP de Odoo?
No, y se complementan. Las skills son documentación: le enseñan al agente cómo se programa en Odoo. El MCP es una conexión: le da acceso a una base de datos de Odoo en marcha para consultar datos reales. Uno resuelve el cómo escribir el código y el otro el con qué datos trabajar.
¿Puedo escribir mis propias skills?
Sí. El formato está documentado y las dos skills de guidelines incluyen un
fichero
AUTHORING.md que explica cómo se estructuran. Es la vía natural
para añadir las convenciones de tu propia empresa junto a las oficiales de Odoo.