Cuando se empieza a trabajar con OpenClaw, una de las piezas más potentes —y también más infravaloradas— son las Skills. No hablamos de simples archivos auxiliares, sino del mecanismo con el que el sistema “enseña” al agente cómo usar herramientas, en qué contexto hacerlo y qué instrucciones debe priorizar. La documentación oficial explica que cada Skill es un directorio con un archivo SKILL.md, con frontmatter YAML e instrucciones en Markdown, y que OpenClaw las carga y filtra según el entorno, la configuración y la disponibilidad de binarios.
La clave está en que OpenClaw no mira una sola carpeta. Reúne Skills desde varias ubicaciones y las ordena por precedencia. En español, la jerarquía oficial de mayor a menor prioridad es esta: <workspace>/skills, <workspace>/.agents/skills, ~/.agents/skills, ~/.openclaw/skills, las Skills incluidas con la instalación y, por último, skills.load.extraDirs.
1. El workspace manda
La carpeta <workspace>/skills ocupa la posición más alta. Esto significa que es el lugar ideal para las Skills específicas de un proyecto concreto: reglas de automatización propias, convenciones internas, integraciones particulares o instrucciones que no tienen sentido fuera de ese entorno. A partir de la precedencia documentada, se deduce que una Skill aquí colocada puede imponerse sobre otra homónima definida en ubicaciones inferiores.
En términos prácticos, esta decisión es muy sensata. El workspace representa el contexto real del trabajo. Si estás desarrollando una app, automatizando un proceso o afinando un flujo para un cliente, lo lógico es que las instrucciones más cercanas a ese proyecto sean las que ganen.
2. Skills del agente del proyecto: una capa intermedia muy útil
Justo debajo aparece <workspace>/.agents/skills. Esta ubicación sirve para encapsular comportamiento del agente a nivel de proyecto sin mezclarlo necesariamente con la capa principal del workspace. Es especialmente útil cuando quieres separar la lógica del proyecto de la configuración más “operativa” del agente.
Aquí encajan muy bien los casos en los que varios agentes colaboran dentro de un mismo repositorio, o cuando necesitas que determinadas instrucciones existan solo en el ámbito de un proyecto, pero no formen parte del conjunto general de Skills visibles desde la raíz principal.
3. Skills personales: tu caja de herramientas reutilizable
La carpeta ~/.agents/skills está pensada para tus Skills personales. Son instrucciones reutilizables, hábitos de trabajo y pequeños aceleradores que quieres tener disponibles en distintos entornos sin depender de un repositorio concreto.
Este nivel tiene mucho valor para perfiles técnicos que trabajan en varios proyectos a la vez. Puedes mantener una colección propia de patrones, plantillas y comportamientos del agente sin copiarlos una y otra vez en cada workspace. OpenClaw los leerá, pero sin darles más peso que a las Skills específicas del proyecto actual.
4. Skills administradas o locales: personalización sin ensuciar el repo
La ruta ~/.openclaw/skills es especialmente interesante porque la propia FAQ oficial la recomienda para personalizar Skills sin tener que modificar la copia del repositorio ni mantener cambios “sucios” en git. También puede combinarse con reglas de visibilidad por agente desde la configuración.
Esta capa es perfecta para overrides locales: ajustes que quieres hacer en tu máquina, cambios temporales, versiones retocadas de una Skill incluida o adaptaciones de trabajo que no deberían subirse al proyecto. Es una forma limpia de personalizar OpenClaw sin romper el flujo de colaboración con otros desarrolladores.
5. Las Skills incluidas: la base que trae OpenClaw
Las Skills incluidas con la instalación son el punto de partida del sistema. Vienen distribuidas con OpenClaw —ya sea en el paquete npm o en la aplicación— y aportan capacidades base que luego pueden complementarse o sobrescribirse desde capas superiores.
Dicho de otro modo: no empiezas desde cero. OpenClaw ya trae una base funcional, y tú decides hasta qué punto la adaptas según el proyecto, el agente o tu entorno personal.
6. skills.load.extraDirs: flexibilidad extra, pero con la prioridad más baja
Al final de la jerarquía aparece skills.load.extraDirs. La configuración oficial la define como un conjunto de directorios adicionales de Skills y deja claro que su precedencia es la más baja.
Esto la convierte en una opción excelente para añadir bibliotecas compartidas, colecciones externas o carpetas comunes que quieras que OpenClaw escanee, pero sin permitir que sustituyan fácilmente lo definido en el proyecto o en tus capas personales. Es una buena solución para equipos que quieren centralizar recursos reutilizables sin imponerlos por encima de la configuración contextual. Esa conclusión se desprende de la propia jerarquía oficial.
Lo importante no es solo dónde cargas una Skill, sino por qué
Entender esta jerarquía cambia por completo la forma de trabajar con OpenClaw. Ya no se trata solo de “guardar una Skill en una carpeta”, sino de decidir qué alcance tendrá y cuánta autoridad le quieres dar.
Si una Skill define comportamiento estrictamente ligado a un proyecto, lo más coherente es ubicarla en <workspace>/skills. Si debe acompañarte entre proyectos, ~/.agents/skills tiene más sentido. Si buscas modificar sin tocar el repositorio, ~/.openclaw/skills es la vía más limpia. Y si simplemente quieres incorporar carpetas externas como apoyo, skills.load.extraDirs encaja mejor. Todo esto está alineado con la precedencia oficial y con las recomendaciones de configuración y FAQ de OpenClaw.
Una arquitectura pequeña, pero con mucho impacto
Lo interesante de este sistema es que resuelve un problema muy real: evitar el caos cuando varias capas de instrucciones conviven al mismo tiempo. OpenClaw no solo carga Skills, también establece una lógica de prioridad para que el agente responda con coherencia según el contexto. Y eso, en entornos de automatización, asistentes técnicos y flujos multiagente, marca la diferencia entre una configuración mantenible y una colección de parches desordenados.
Las Skills, bien organizadas, convierten OpenClaw en una plataforma mucho más flexible. No son un añadido decorativo: son una parte central del control operativo del agente.
Toni Domenech