Qué es una skill de agente (SKILL.md) y cómo revisarla

Una skill es una carpeta con un archivo SKILL.md que se ubica donde tu agente de código lo busca. El agente lee el archivo solo cuando tu solicitud coincide con él. Hasta entonces, la skill cuesta unos cien tokens, mientras que un prompt viaja con cada mensaje en el que lo pegas.

Probablemente ya te topaste con la palabra en un README: "instala la skill y luego pídele al agente que...". No hay nada misterioso. A continuación: qué contiene, cuándo entra en la ventana de contexto y cómo revisar una antes de dejarla entrar en tu máquina.

Qué es una skill y en qué se diferencia de un prompt#

La documentación de Agent Skills de Anthropic (consultada el 30 de octubre de 2026) describe una skill como un recurso reutilizable basado en el sistema de archivos: un directorio con un archivo SKILL.md, más scripts, plantillas y archivos de referencia opcionales. SKILL.md comienza con un pequeño encabezado YAML (un nombre y una descripción) y continúa con instrucciones en texto plano.

Piensa en un colega nuevo. Un prompt eres tú parado detrás de su silla repitiendo las reglas cada mañana. Una skill es una carpeta en el estante con una etiqueta en el lomo: "Estilo de mensajes de commit. Léela cuando alguien te pida hacer un commit". La bajan solo cuando hace falta.

Se requieren dos campos de encabezado, y el formato tiene reglas. En el formato Skills de Claude, el name tiene como máximo 64 caracteres: letras minúsculas, dígitos y guiones, y no puede contener las palabras "anthropic" ni "claude". El description no puede estar vacío, tiene un límite de 1.024 caracteres y debe decir tanto qué hace la skill como cuándo usarla.

Cómo entra una skill en la ventana de contexto#

La documentación llama a esto divulgación progresiva: el agente lee una skill en tres etapas, y cada etapa se paga solo si se alcanza.

• Nivel 1, siempre cargado. El nombre y la descripción de cada skill instalada, unos 100 tokens por skill.
• Nivel 2, cuando se activa. El cuerpo de SKILL.md, menos de 5.000 tokens.
• Nivel 3, solo cuando hace falta. Archivos y scripts incluidos. Cuando el agente ejecuta un script, el código del script no entra en el contexto, solo su salida.

Las cifras de tokens son aproximaciones de la documentación, no conteos exactos.

He aquí por qué esto importa para tu factura. Supón que tienes 20 skills instaladas. 20 × 100 = 2.000 tokens viajan desde el primer mensaje. Un agente reenvía su contexto en cada paso (el ejemplo de 20 pasos muestra por qué), así que una sesión de 50 pasos lleva 50 × 2.000 = 100.000 tokens de entrada en etiquetas de skills. En DeepSeek-V4-Flash eso es $0.0015 a los precios actuales.

Ahora al revés. Si esas veinte skills se pegaran como un gran prompt, cada cuerpo estaría en cada solicitud: hasta 20 × 5.000 = 100.000 tokens por solicitud, no por sesión. Esa diferencia es todo el sentido de cargar bajo demanda. Si el término "ventana de contexto" todavía te resulta difuso, esta explicación cubre qué la llena.

Las skills viven en el contexto, así que el modelo detrás del agente necesita espacio para ellas. DeepSeek-V4-Flash en CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) tiene una ventana de contexto de 380K y hasta 32.768 tokens de salida por respuesta, un solo precio a cualquier hora del día, y una API compatible con OpenAI y Anthropic. Para el agente de terminal, sigue cómo conectar Claude Code a CheapTokens; para cualquier otra herramienta, empieza por la documentación. La página del modelo está aquí.

Escribe una skill mínima en dos minutos#

Leer es más fácil después de escribir una. Esta skill hace que el agente escriba mensajes de commit en un formato fijo. En Claude Code, las skills personales viven en ~/.claude/skills/ y las de proyecto en .claude/skills/, así que una skill de proyecto puede viajar con el repositorio.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Pega esto en el archivo:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Ahora abre el agente en un repositorio con cambios en el área de preparación y pide: "escribe un mensaje de commit para lo que preparé". El agente ve la descripción, decide que coincide, lee las cuatro reglas y las sigue. Si ignora la skill, mira primero el description: tiene que nombrar la situación, aquí "commit", con las palabras que realmente usarías.

Un detalle: las skills no se sincronizan entre claude.ai, la API y Claude Code. Una skill que creaste en un lugar tiene que añadirse a los demás por separado.

Skill, AGENTS.md, MCP: cuál es cuál#

Estos tres se confunden todo el tiempo. Un archivo de reglas como AGENTS.md o CLAUDE.md se lee al inicio de una sesión y contiene hechos sobre el proyecto (cómo ese archivo puede salir mal en una carpeta de Descargas). Un servidor MCP le da al agente nuevas herramientas y datos a los que acceder (MCP en lenguaje llano). Una skill es un procedimiento: cómo hacer un tipo de trabajo, cargado cuando ese trabajo surge.

Revisa una skill de terceros antes de instalarla#

Una skill es texto que el agente sigue, y a veces código que el agente ejecuta. La documentación dice usar skills solo de fuentes confiables, auditar cada archivo incluido (SKILL.md, scripts, recursos) y buscar llamadas de red o accesos a archivos inesperados. Las skills que obtienen URLs externas son más riesgosas. En Claude Code, una skill tiene el mismo acceso a la red que cualquier programa de tu computadora, así que trata la instalación como instalar software.

Un buen espécimen es universal-modder, un kit de herramientas para modding de juegos. Su README (consultado el 30 de octubre de 2026) describe un conjunto de skills con licencia MIT en el formato Agent Skills, una CLI de Python llamada um, un servidor MCP para generar recursos mediante fal, y una base de conocimiento compartida de notas de campo. La skill principal, mod-any-game, cubre reconocimiento, ingeniería inversa, generación de recursos, pruebas en el juego y empaquetado. El README lista Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot y OpenCode como herramientas compatibles, y dice que el kit se niega a eludir anti-cheat o DRM. En Claude Code se instala con /plugin marketplace add rehan-remade/universal-modder, y la generación de recursos necesita una clave de API de fal aparte.

Fíjate en lo que contiene esa lista: skills, un programa de línea de comandos y un servidor. Leer un solo SKILL.md cubriría solo una parte de lo que estás instalando. Así que revisa las piezas:

La regla clave está en cómo guardar una clave de API de forma segura. La página del repositorio no muestra la fecha del último commit, así que revisa qué tan recientemente se actualizó el proyecto antes de confiar en él.