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.
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 del addon, 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
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ú. Le dices que revise y ella mira cada fichero que has tocado y le aplica las reglas que le corresponden: el Python con odoo-guidelines, el JavaScript con odoo-web-guidelines y la seguridad con odoo-security. A las otras tres no las llamas nunca a mano.
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.
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-currentSi 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:
tree -L 2 ~/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.
Elige la carpeta de destino según 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
los cubres 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/ |
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/
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.
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í. Las skills usan el formato abierto Agent Skills, que soportan Claude Code,
Codex, Cursor, GitHub Copilot en VS Code, OpenCode y bastantes más. Lo único que
cambia es la carpeta donde cada uno las busca, y cuatro de los cinco leen la misma:
~/.agents/skills/. Por eso en la guía se copian a dos rutas y con eso
quedan cubiertos todos.
¿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.