# Skills de agentes de IA: qué son y cómo escribir uno que funcione > Los skills de agentes de IA convierten las instrucciones que repites en archivos que el agente carga cuando los necesita. Descubre cómo funciona SKILL.md, consulta ejemplos reales y aprende a crear uno. Last updated: 2026-09-28T10:00:00 Canonical URL: https://crevio.co/es/blog/ai-agent-skills *Última actualización: septiembre de 2026* **Si has explicado tu política de reembolsos a un agente de IA más de dos veces, ya has escrito un skill de agente. Lo que pasa es que sigues borrándolo.** Los skills de agentes de IA son la solución: un archivo breve que contiene un procedimiento y que el agente lee solo cuando una tarea lo requiere. Escribe las reglas una vez y todas las conversaciones futuras partirán de ellas. Esta guía está dirigida a propietarios y responsables de pequeñas empresas que utilizan un agente de IA para trabajar de verdad y están cansados de tener que explicarle lo mismo una y otra vez. En ella descubrirás qué es exactamente un skill, cómo deciden los agentes cuándo cargarlo, qué tareas lo necesitan y cómo crear un ejemplo completo que puedes copiar. - **Un skill es una carpeta con un archivo SKILL.md**: un nombre, una descripción breve y las instrucciones. Los scripts y archivos de referencia son opcionales - **Los agentes solo leen la descripción al principio** (unos 100 tokens por skill). El resto se carga cuando coincide con una tarea, así que una biblioteca grande sigue teniendo un coste bajo - **Es un estándar abierto.** El mismo skill funciona en Claude, ChatGPT y Codex, Gemini CLI, Cursor, GitHub Copilot y decenas de agentes más - **La descripción es la parte más importante.** Si es vaga, el skill no se activará o se activará para la tarea equivocada - **Los skills de terceros son código que estás instalando.** Una auditoría de febrero de 2026 detectó problemas de seguridad críticos en el 13,4 % de los skills públicos ## ¿Qué son los skills de agentes de IA? **Los skills de agentes de IA son paquetes reutilizables de instrucciones que enseñan a un agente a realizar una tarea concreta a tu manera.** Cada skill es una carpeta que contiene un archivo `SKILL.md`. Ese archivo comienza con una breve cabecera (un `name` y un `description`), seguida de instrucciones en lenguaje claro: los pasos, las reglas, el formato de salida y los casos especiales. La idea surgió de Anthropic, que [presentó Agent Skills en octubre de 2025](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) y los describió como «carpetas organizadas de instrucciones, scripts y recursos que los agentes pueden descubrir y cargar dinámicamente». En diciembre de 2025 publicó el formato como estándar abierto en [agentskills.io](https://agentskills.io/home), y desde entonces la mayoría de los agentes principales lo han adoptado. ![Publicación de ingeniería de Anthropic en la que se presentan los Agent Skills, publicada el 16 de octubre de 2025](https://crevio.co/vite/assets/anthropic-agent-skills-announcement-fr3rjecj.png) El término también se usa de forma imprecisa para referirse a «las cosas que pueden hacer los agentes de IA» o a las habilidades humanas necesarias para gestionar agentes. Son temas reales, pero cuando quienes crean o compran agentes hablan de «skills» en 2026, casi siempre se refieren a esto: un procedimiento empaquetado que el agente puede incorporar y dejar de usar cuando quiera. ### Qué contiene una carpeta de skills La [especificación de Agent Skills](https://agentskills.io/specification) mantiene la estructura deliberadamente sencilla: | Parte | ¿Obligatoria? | Qué incluye | |---|---|---| | `SKILL.md` | Sí | Cabecera con `name` y `description`, seguida de las instrucciones | | `scripts/` | No | Código que el agente puede ejecutar, como un generador de informes o un validador | | `references/` | No | Documentos más extensos: tu política completa, una lista de precios o una guía de estilo | | `assets/` | No | Plantillas, archivos de ejemplo y tablas de consulta | La cabecera tiene límites estrictos. El `name` puede tener hasta 64 caracteres en minúscula, números y guiones. El `description` puede tener hasta 1.024 caracteres y, según la especificación, «debería describir tanto lo que hace el skill como cuándo debe utilizarse». ![Página de la especificación de Agent Skills que muestra el archivo SKILL.md obligatorio y las carpetas opcionales de scripts, referencias y recursos](https://crevio.co/vite/assets/agentskills-specification-idwfflfk.png) ## Cómo cargan los skills los agentes La parte más ingeniosa del formato es que un agente no lee todos los skills a la vez. Los carga en tres niveles, lo que la especificación denomina **divulgación progresiva**. ![Diagrama de los tres niveles que carga un agente: el nombre y la descripción siempre; las instrucciones de SKILL.md cuando coincide con una tarea; y las referencias o los scripts solo cuando un paso los necesita](https://crevio.co/vite/assets/how-agents-load-skills-g1wbt1jh.svg) 1. **Descubrimiento.** Al comienzo de cada sesión, el agente solo lee el nombre y la descripción de cada skill instalado, aproximadamente 100 tokens por skill 2. **Activación.** Cuando tu solicitud coincide con una descripción, el agente lee el `SKILL.md` completo de ese skill. La especificación recomienda mantenerlo por debajo de 5.000 tokens y 500 líneas 3. **Ejecución.** El agente sigue las instrucciones y abre un archivo de referencia o ejecuta un script solo cuando un paso lo indica Por eso una empresa puede tener decenas de skills instalados sin ralentizar el agente ni pagar por un contexto que nunca utiliza. También por eso la descripción tiene tanto peso: es la única parte que el agente ve antes de decidir. La [guía de creación de Anthropic](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) indica que el agente puede elegir entre «más de 100 Skills disponibles» usando solo ese campo. ## Skills frente a prompts, herramientas y memoria Los skills se solapan con varios elementos que quizá ya utilizas. La diferencia está en lo que contiene cada uno y en cuándo aparece. | | Qué contiene | Cuándo lo ve el agente | Ideal para | |---|---|---|---| | **Prompt** | Una solicitud | Solo esta conversación | Tareas puntuales | | **Instrucciones personalizadas** | Preferencias permanentes | En todas las conversaciones, siempre | Tono, nombre y zona horaria | | **Memoria** | Datos que el agente ha aprendido | Cuando los recuerda | «Noviembre es nuestro mes con más actividad» | | **Herramienta o integración** | Acceso a un sistema | Cuando necesita actuar | Leer pedidos o enviar correos | | **Skill** | Un procedimiento | Solo cuando coincide con la tarea | «Cómo gestionamos los reembolsos» | La pareja que más se confunde es la de los skills y las herramientas. **Una herramienta le da al agente la llave; un skill le indica qué hacer una vez dentro.** Un skill que diga «comprueba el pedido en nuestra tienda» no sirve de nada si el agente no tiene acceso a ella, y tener acceso a la tienda es arriesgado si no existe un skill que indique qué puede y qué no puede hacer allí. Normalmente necesitas ambas cosas. Los skills y la memoria también son lo que diferencia a un agente que parte de cero cada vez de otro que mejora con el uso. Esa es la distinción que planteamos en [Empleado de IA frente a agente de IA](/es/blog/ai-employee-vs-ai-agent). ## Dónde funcionan hoy los skills de agentes de IA Como el formato es un estándar abierto, un skill que escribas no queda vinculado a un solo producto. La [lista de clientes de agentskills.io](https://agentskills.io/home) incluye Claude y [Claude Code](/es/blog/claude-code), ChatGPT y Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code, OpenCode, Goose, Databricks, Snowflake y más de 30 opciones. Después llegaron los directorios públicos. [skills.sh](https://skills.sh/) incluye skills de la comunidad que puedes instalar con un solo comando, desde skills de redacción e investigación hasta otros creados para herramientas concretas. ![skills.sh, un directorio público de skills de agentes de la comunidad con una clasificación de instalaciones](https://crevio.co/vite/assets/skills-sh-directory-f00n0in6.png) Gran parte de esa biblioteca está creada por desarrolladores para agentes de programación. Los skills importantes para gestionar una empresa rara vez aparecen en una clasificación, porque codifican cosas que solo tú conoces: tus políticas, tu voz y tus cifras. ## Ejemplos de skills de agentes de IA para una pequeña empresa Así podría ser una biblioteca inicial de skills para una empresa que vende productos o servicios digitales: | Skill | Qué codifica | Se activa cuando | |---|---|---| | `handling-refund-requests` | La política de reembolsos, las reglas de aprobación y el tono de las respuestas | Un cliente pide que le devuelvan el dinero | | `writing-weekly-report` | Qué cifras usar, en qué orden y qué se considera «destacable» | Preguntas cómo ha ido la semana | | `writing-in-brand-voice` | Las palabras que usas, las que nunca usas y ejemplos de correos | Hay que redactar algo dirigido a un cliente | | `launching-a-product` | Tu lista de comprobación de lanzamiento, la secuencia de correos y las reglas de precios | Dices «vamos a lanzar X» | | `qualifying-leads` | Quién encaja, qué preguntar y cuándo concertar una llamada | Llega un nuevo lead | | `pricing-a-custom-quote` | La tabla de tarifas, los mínimos y los descuentos permitidos | Un posible cliente pregunta «¿cuánto cuesta?» | Fíjate en lo que falta: «escribe una entrada de blog» o «resume este PDF». El modelo ya hace bien esas tareas. Un skill se gana su sitio cuando contiene un contexto que el agente no puede adivinar. ## Qué merece un skill (y qué no) Antes de escribir nada, clasifica la tarea con dos preguntas: ¿con qué frecuencia se repite? y ¿se equivoca el agente sin tu contexto? ![Matriz de dos por dos: escribe un skill solo para tareas que se repiten a menudo y con las que el agente se equivoca sin tu contexto](https://crevio.co/vite/assets/what-deserves-a-skill-bje0433g.svg) PostHog, cuyos equipos han publicado 226 skills en una tienda interna de skills, llega a la misma conclusión en [su artículo sobre la creación de skills](https://posthog.com/newsletter/writing-agent-skills): crea skills para trabajos que se repiten, que a los agentes les cuestan de forma predeterminada o que necesitan un contexto poco evidente. Todo lo demás es una carga adicional que dificulta la elección del agente. ## Cómo escribir un skill de agente de IA No necesitas programar. Un skill útil es un documento de procedimiento bien escrito y con una cabecera clara. ### Paso 1: realiza primero la tarea con el agente El propio consejo de Anthropic es empezar con una conversación real, no con un archivo en blanco. Completa la tarea una vez, corrige al agente sobre la marcha y fíjate en todo lo que has tenido que explicarle. Esas correcciones son el skill. ### Paso 2: escribe la descripción antes que nada La descripción determina si el skill llegará a cargarse. Escríbela en tercera persona, explica qué hace el skill e incluye las frases que podría contener una solicitud real: - **Débil:** «Ayuda con los clientes». - **Fuerte:** «Gestiona las solicitudes de reembolso de productos digitales. Úsalo cuando un cliente pida un reembolso, diga que una compra no ha funcionado o mencione un contracargo». ### Paso 3: escribe el cuerpo como objetivos y reglas, no como un guion Indica el objetivo, las reglas estrictas, los pasos, el formato de salida y los casos especiales. Sé preciso con las limitaciones y flexible con la redacción. Merece la pena citar la advertencia de PostHog: «Especificar demasiado convierte un skill en un flujo de trabajo y elimina la inteligencia por la que estás pagando». ### Paso 4: mueve el material extenso a las referencias Si tu política completa ocupa tres páginas, ponla en `references/refund-policy.md` e indica al agente exactamente cuándo debe abrirla. Mantén las referencias a un solo nivel: los archivos que apuntan a otros archivos suelen leerse solo a medias. ### Paso 5: pruébalo con tres solicitudes reales Haz tres solicitudes realistas, incluida una que *no* debería activar el skill. Si se activa para la tarea equivocada o no detecta una evidente, casi siempre el problema está en la descripción. ### Un ejemplo completo que puedes copiar ``` --- name: handling-refund-requests description: Handles refund requests for digital products (courses, templates, downloads). Use when a customer asks for a refund, says a purchase did not work, disputes a charge, or mentions a chargeback. --- # Handling refund requests ## Goal Resolve the request in one reply and keep the customer where possible. Never refund outside policy without the owner's approval. ## Policy - Courses: full refund within 14 days if under 30% of lessons completed - Templates and downloads: no refund after download; offer a fix or an exchange - Duplicate purchases: always refund the duplicate ## Steps 1. Look up the order: product type, purchase date, usage 2. Compare against the policy above 3. Within policy: draft the refund and the reply, then ask for approval 4. Outside policy: draft a reply offering the fix or exchange. Do not promise a refund 5. Chargeback, lawyer, or angry repeat contact: stop and hand it to the owner ## Reply style Short and warm. Use their first name. Apologize once, not three times. Sign off as "The Studio Team". ## Edge cases - Bought the wrong course: offer a free swap before a refund - Payment failed but they were charged: treat as a duplicate ``` Tiene menos de 250 palabras y sustituye una conversación que, de otro modo, tendrías que repetir cada semana. ## Lo que nadie te cuenta sobre los skills de agentes El formato es sencillo. Las sorpresas aparecen después de convivir varios meses con una biblioteca de skills. **Los skills chocan entre sí cuando la biblioteca crece.** El artículo de PostHog cita a Databricks, que detectó lo mismo: «los agentes eligen cada vez más el skill equivocado a medida que se añaden otros». Dos skills con descripciones que se solapan («correos para clientes» y «respuestas de soporte») se alternarán de forma imprevisible. Fusiónalos o haz que cada descripción indique en qué situaciones no se aplica la otra. **Los skills se quedan obsoletos en silencio.** Cambia el plazo de reembolso, cambian tus precios, se renombra una herramienta y el skill sigue aplicando con seguridad las reglas antiguas. Pon todo lo que pueda cambiar en un único archivo de referencia que mantengas actualizado, como harías en una [base de conocimiento para agentes de IA](/es/blog/ai-agent-knowledge-base), y revisa los skills cada vez que cambie la política subyacente. **Los skills de terceros son software, no texto.** Snyk analizó 3.984 skills públicos en febrero de 2026 y [detectó fallos de seguridad en el 36,82 % y problemas críticos en el 13,4 %](https://snyk.io/blog/toxicskills-malicious-ai-agent-skills-clawhub/), incluidos 76 payloads maliciosos confirmados diseñados para robar credenciales, instalar puertas traseras o extraer datos. La recomendación de Anthropic es clara: instala skills solo de fuentes en las que confíes y lee primero cualquier otro. Abordamos el mismo riesgo al analizar las [alternativas a OpenClaw](/es/blog/openclaw-alternatives), donde los skills de la comunidad eran una de las principales preocupaciones. **Un skill no concede permisos.** Las instrucciones que dicen «emite el reembolso» no sirven de nada sin acceso a tu sistema de pagos, y el acceso sin límites es un peligro aún mayor. Mantén el dinero, los envíos y las eliminaciones detrás de un paso de aprobación, independientemente de lo que diga el skill. Es la misma regla que aplicamos al [delegar trabajo a agentes de IA en una pequeña empresa](/es/blog/ai-agents-for-small-business): todo lo que salga de la empresa debe prepararse como borrador, no enviarse. ## Cómo utiliza Crevio los skills [Crevio](https://crevio.co/) es un creador de negocios con IA: describes lo que quieres vender y su agente crea la tienda, gestiona los pagos, redacta el marketing y sigue trabajando contigo en el negocio. Los skills permiten que ese agente conserve los conocimientos entre conversaciones. ![Página de inicio de Crevio: IA que crea tu tienda, procesa tus pagos, redacta tu marketing y aumenta tus ventas](https://crevio.co/vite/assets/crevio-homepage-nvib9pqi.png) Así funciona en la práctica: - **Viene con skills integrados.** El agente incluye skills para correos en frío, lead magnets, precios, [auditorías SEO](/es/blog/ai-agents-for-seo), creatividades publicitarias, publicaciones en redes sociales y trabajo con PDF, hojas de cálculo, documentos y presentaciones - **Puedes instalar y subir los tuyos.** La página Skills de los ajustes incluye un marketplace de skills de la comunidad y permite subir los tuyos como `.zip`, como carpeta o como un único `SKILL.md`. Los skills subidos permanecen privados en tu cuenta - **Escribe skills a partir de la experiencia.** Después de una tarea larga y compleja, Crevio revisa lo ocurrido y guarda la parte que puede reutilizarse como un skill. Estos skills aparecen en «Aprendido por tu IA», donde puedes leerlos o eliminarlos - **Puedes enseñar mediante una demostración.** «Enseñar una tarea» graba cómo haces algo en el ordenador del agente y Crevio convierte la grabación en un skill reutilizable La salvedad importante: un skill que el agente ha escrito para sí mismo solo será tan bueno como la conversación de la que ha aprendido. Lee lo que ha guardado, especialmente si afecta al dinero o a los clientes. Crevio tiene un plan gratuito, así que puedes probar la biblioteca de skills sin introducir una tarjeta. ## Preguntas frecuentes ### ¿Los skills de agentes son lo mismo que MCP? No. MCP (Model Context Protocol) es una de las distintas formas de [conectar un agente con las aplicaciones de tu empresa](/es/blog/connect-ai-agents-to-business-apps), como tu CRM o tu bandeja de entrada. Un skill es un procedimiento escrito que indica al agente cómo utilizar lo que tiene. Funcionan juntos: MCP proporciona el acceso y el skill aporta el criterio sobre cuándo y cómo utilizarlo. ### ¿Necesito programar para escribir un skill de agente de IA? No. La mayoría de los skills útiles para empresas son Markdown sencillo: una cabecera, un objetivo, reglas y pasos. Los scripts son opcionales y solo merece la pena añadirlos para pasos que deban ejecutarse exactamente igual cada vez, como generar un informe con formato o comprobar un cálculo. ### ¿Los skills de Claude son lo mismo que los skills de agentes? Sí, en la práctica. Anthropic creó el formato para Claude y después lo publicó como estándar abierto Agent Skills. Un skill escrito para Claude suele funcionar en cualquier agente compatible con el estándar, siempre que no dependa de una herramienta que solo tenga un producto. ### ¿Cuántos skills debería tener un agente? Todos los que correspondan a procedimientos distintos y repetidos, y ninguno más. El coste de carga es reducido, pero las descripciones que se solapan hacen que el agente elija el skill equivocado. Si dos skills podrían responder razonablemente a la misma solicitud, fusiónalos. ## En resumen Los skills de agentes de IA son la diferencia entre gestionar un agente y haberlo entrenado. Empieza por el procedimiento que no paras de explicar, escribe la descripción como si todo dependiera de ella y mantén breve el resto. La mejor biblioteca de skills no es la más grande, sino aquella en la que cada archivo contiene algo que te cansaste de repetir. ## Artículos relacionados - [Empleado de IA frente a agente de IA: la diferencia que realmente importa](/es/blog/ai-employee-vs-ai-agent) - [Agentes de IA para pequeñas empresas: qué tareas delegar primero](/es/blog/ai-agents-for-small-business) - [Los mejores agentes de IA para Slack en 2026 (11 herramientas comparadas)](/es/blog/best-ai-agents-for-slack)