Dominando las Skills del Agente Claude - La Guía Completa para Construir tu Arsenal de Superpoderes de IA

El Momento en que Entendí lo que Realmente son las Skills

Déjame contarte una historia. Imagina que te piden que seas el mentor de una nueva contratación brillante en el trabajo. Esta persona es increíblemente inteligente — aprende más rápido que nadie que hayas visto, puede entender casi cualquier cosa que le expliques, habla elocuentemente sobre cualquier tema. Pero hay un problema: no conoce las reglas de tu empresa.

Cada mañana, te sientas con ella y le explicas las mismas cosas. "Así es como formateamos los informes. Este es nuestro estilo de código. Aquí es a quién poner en copia en los correos electrónicos. Esta es la plantilla para las propuestas de los clientes." Y cada mañana, después del almuerzo, de alguna manera lo ha olvidado todo. No porque sea estúpida — es brillante. Pero no tiene memoria persistente de la forma de hacer las cosas de tu empresa.

Así es exactamente como se sentía trabajar con IA.

Los Prompts son como estar parado junto a esa nueva contratación, dando instrucciones verbales en el momento. "Escribe este correo electrónico de manera más formal." "Usa viñetas aquí." "Revisa este código en busca de errores." Funciona. Pero en el momento en que cierras la conversación, todo desaparece. Cada nuevo chat comienza desde cero.

Las Skills son como entregarles un manual de SOP interno — una carpeta de base de conocimientos que contiene especificaciones, scripts, plantillas y materiales de referencia. El Agente buscará lo que necesita cuando lo necesite. Y crucialmente, este manual persiste en cada conversación.

Aquí está la revelación clave: Las Skills no son solo prompts sofisticados. Son un paradigma completamente diferente. Un prompt es reactivo — das una instrucción, obtienes una respuesta. Una Skill es proactiva — se queda ahí, esperando ser descubierta y aplicada cuando es relevante, funcionando de la misma manera cada vez.

Lo Que Realmente Contiene una Skill

Cada Skill es una carpeta, no solo un archivo de texto. Esto es crucial de entender. Dentro de esa carpeta, puedes tener:

Cuando vi esta estructura por primera vez, pensé: "Espera, esto es como construir una pequeña aplicación". Y eso es exactamente correcto. Cada Skill es un módulo de capacidad autónomo. Algunas son simples — solo un archivo markdown con reglas de revisión. Otras son complejas — completas con scripts de Python que procesan datos, suben a servidores y generan informes.

¿Cuándo Llegaron las Skills?

Anthropic lanzó Skills para Claude Code en octubre de 2025. Al principio, pensé que era solo otra actualización de características. Pero luego sucedió algo en diciembre de 2025 — abrieron las Skills como un estándar a través de agentskills.io. De repente, las skills no eran solo una cosa de Claude. El Codex CLI de OpenAI adoptó la misma arquitectura. Cursor, Codebuddy, OpenCode — todos comenzaron a construir compatibilidad.

Las Skills se convirtieron en el estándar de facto para la extensión de capacidades de Agentes de IA, al igual que MCP se convirtió rápidamente en el protocolo de todos para conexiones externas.

¿Y la popularidad? Déjame ponerlo de esta manera: Un repositorio que contiene más de 50 skills de Claude alcanzó 18K estrellas en GitHub. La palabra "Skills" es ahora tan omnipresente en los círculos de IA como lo era "Prompt" en 2023.

Divulgación Progresiva - Por Qué Este Diseño es Genial

Antes de entender la divulgación progresiva, tenía una preocupación persistente: "Si instalo 50 skills, ¿no explotará el contexto de Claude? ¿No quemaré miles de tokens solo cargando descripciones de skills?"

Aquí es donde brilla la genialidad del diseño de Anthropic. Tomaron prestado un concepto del diseño de UX — divulgación progresiva (progressive disclosure) — y lo aplicaron perfectamente a la gestión del contexto de IA.

El Sistema de Carga de Tres Capas

La divulgación progresiva significa cargar en etapas y bajo demanda. Claude no vuelca todo en el contexto al inicio. En su lugar, utiliza un sistema de tres capas:

Hagamos las Cuentas

Aquí hay una comparación que me hizo apreciar este diseño:

Eso es una reducción del 75% en el consumo de tokens. Y esto ni siquiera cuenta la ventaja del script.

La Magia de los Scripts

Aquí es donde las Skills dejan atrás a los prompts. Cuando una Skill incluye un script, sucede algo notable:

1. Claude genera un comando: python scripts/upload_image.py image.png
2. El script se ejecuta localmente en tu máquina
3. Solo la salida (como una URL de imagen) regresa a Claude

El código del script en sí nunca entra en el contexto.

Piensa en lo que esto significa. Puedes escribir un script de Python de 500 líneas manejando cada caso extremo, con manejo robusto de errores, registros, reintentos — todas las cosas que hincharían un prompt imposiblemente. Claude solo necesita saber "ejecuta este script". La complejidad está encapsulada.

La Analogía del Menú Móvil

Si alguna vez has diseñado una aplicación móvil, conoces íntimamente la divulgación progresiva. Es por eso que tenemos menús de hamburguesa — no mostramos a los usuarios 47 opciones de inmediato. Mostramos un ícono de menú. Tocan. Ven categorías. Tocan de nuevo. Llegan a la configuración que desean.

¿El propósito? Nunca abrumar con información. Descomponer en trozos digeribles. Dejar que los usuarios (o en este caso, la IA) se concentren en la tarea actual con una carga cognitiva mínima.

Los humanos pueden retener alrededor de 7±2 fragmentos de información en la memoria de trabajo. La IA, limitada por la ventana de contexto, tiene esencialmente la misma restricción. La divulgación progresiva respeta esta limitación en ambos casos.

Skills vs MCP vs Subagente - Finalmente Desenmarañados

Esta pregunta me persiguió durante semanas. MCP, Skills, Subagente — todos parecen "extender las capacidades de Claude". ¿Cuál es la diferencia real? Después de construir con los tres, finalmente tengo una respuesta que tiene sentido.

La Distinción en Una Frase

MCP permite que Claude toque sistemas externos. Las Skills le dicen a Claude cómo usar lo que toca. El Subagente envía a alguien más a hacer el trabajo.

Permíteme desglosar eso con analogías que realmente me ayudaron a entender:

La Tabla de Comparación

Cuándo Usar Cuál

Usa MCP cuando necesites conectar con sistemas externos:

• Consultar una base de datos
• Llamar a APIs de terceros
• Leer/escribir en Notion, Jira, GitHub, Salesforce
• Acceder a cualquier servicio que requiera autenticación

Usa Skills cuando tengas flujos de trabajo repetitivos:

• Procesos de revisión de código con listas de verificación específicas
• Revisión de artículos con reglas de estilo consistentes
• Generación de informes con formatos estandarizados
• Cualquier instrucción que te encuentres escribiendo repetidamente

Usa Subagente cuando las tareas son complejas y paralelizables:

• Revisar una base de código completa (consume tiempo)
• Procesar múltiples tareas independientes simultáneamente
• Prevenir la contaminación del contexto entre trabajos no relacionados

Trabajan Juntos

Aquí está la parte hermosa: estas no son tecnologías competidoras. Son capas complementarias.

Un flujo de trabajo complejo podría usar los tres:

1. MCP conecta con Salesforce para extraer datos de ventas
2. Skills definen el proceso de análisis de datos — cómo calcular métricas, generar informes
3. Subagente procesa diferentes análisis regionales en paralelo

En mi propio flujo de trabajo de escritura:

• Las Skills definen mis reglas de revisión y guía de estilo
• Scripts (empaquetados en skills) suben imágenes a mi servicio de alojamiento
• Estoy planeando añadir MCP para conectar con mi base de datos de materiales

Por Qué Simon Willison Dice que las Skills Podrían Ser Más Grandes que MCP

Simon Willison es una de las voces más respetadas en la comunidad de desarrolladores de IA. Cuando escribió que "Las Skills podrían ser algo más grande que MCP", la gente prestó atención. Después de meses usando ambos, entiendo exactamente por qué lo dijo.

Razón 1: Eficiencia de Tokens

MCP tiene un problema fundamental: la inflación de tokens.

Cuando conectas un servidor MCP, Claude necesita entender qué puede hacer ese servidor. Cada función disponible, cada parámetro, cada tipo de retorno — todo necesita estar en el contexto. Simon señaló que solo el servidor MCP oficial de GitHub consume decenas de miles de tokens.

Las Skills evitan esto elegantemente. Cargan solo metadatos (100 tokens cada una), luego cargan instrucciones completas solo cuando se activan. La diferencia de eficiencia es asombrosa.

Razón 2: La Ventaja de la Simplicidad

Para construir un servidor MCP, necesitas:

• Entender la especificación del protocolo
• Escribir código del lado del servidor
• Configurar JSON correctamente
• Manejar la comunicación y los estados de error

¿Para construir una Skill?

Solo escribe Markdown.

Si puedes escribir documentación, puedes escribir Skills. La diferencia de umbral es enorme. Y en tecnología, las barreras más bajas para la creación siempre conducen a un crecimiento explosivo.

Razón 3: Compatibilidad Multiplataforma

Los servidores MCP suelen ser específicos del host. Algo construido para Claude Code podría no funcionar en otros lugares sin modificación.

Las Skills son solo carpetas con Markdown y scripts opcionales. No dependen de la tecnología propietaria de Anthropic. Simon señaló que puedes apuntar la misma carpeta de Skill a Codex CLI, Gemini CLI — funcionarán incluso sin soporte nativo de Skills, porque en su núcleo, las skills son solo instrucciones bien estructuradas.

Esta portabilidad es la razón por la que OpenAI adoptó esencialmente la misma arquitectura en Codex CLI. Las Skills se están convirtiendo en un estándar universal.

Razón 4: La Predicción de la Explosión Cámbrica

"Predigo que las Skills traerán una explosión cámbrica más espectacular que la locura de MCP el año pasado."

¿Por qué? Porque cuando el umbral de creación baja lo suficiente, las contribuciones de la comunidad explotan. Escribir un servidor MCP requiere habilidades de desarrollo backend. Escribir una Skill requiere saber cómo escribir un documento.

Ya estamos viendo que esta predicción se hace realidad. Los mercados de Skills están apareciendo por todas partes. Los repositorios de GitHub están repletos de contribuciones de la comunidad. El ecosistema está creciendo más rápido de lo que nadie anticipó.

Mi Propia Observación

Después de meses con ambas tecnologías, estoy de acuerdo con la evaluación de Simon. Las Skills se sienten más alineadas con la forma en que los LLM funcionan naturalmente — entendiendo texto, siguiendo instrucciones, aplicando conocimiento contextualmente.

MCP representa el pensamiento tradicional de ingeniería de software: definir interfaces, implementar servicios, manejar protocolos.

Las Skills representan el pensamiento nativo de IA: escribe claramente cómo hacer algo, deja que el modelo descubra cuándo y cómo aplicarlo.

Ambos tienen su lugar. Pero las Skills podrían ser el cambio de paradigma más profundo.

La Anatomia de una Skill Perfecta

Déjame guiarte a través de la estructura de una Skill bien elaborada. Esto no es solo teoría — entender esta anatomía hará que todo lo demás en esta guía tenga sentido.

La Estructura de Carpetas

my-skill/
├── SKILL.md                 # Instrucciones principales (obligatorio)
├── scripts/
│   └── process.py           # Script ejecutable
├── references/
│   └── DETAILED_GUIDE.md    # Doc de referencia detallado
└── assets/
    └── template.md          # Recurso de plantilla

El Archivo SKILL.md

Este es el corazón de tu skill. Tiene dos partes:

---
name: my-awesome-skill
description: Breve explicación de lo que hace esta skill y cuándo usarla. Incluye palabras clave de activación.
---

# My Awesome Skill

## Instructions

Guía paso a paso para que Claude la siga cuando se invoca esta skill.

## Examples

Demostraciones concretas de entrada/salida o patrones de uso.

## Guidelines

Cualquier regla, restricción o mejor práctica a seguir.

El Frontmatter YAML

La sección entre los marcadores --- es crucial. Es lo que Claude lee para decidir si usar tu skill.

Opciones Avanzadas de Frontmatter

Más allá del nombre y la descripción, las Skills admiten poderosas opciones de configuración:

La Regla de Oro: 500 Líneas

Convenciones de Nomenclatura

El nombre de tu carpeta importa. Debe ser letras minúsculas + guiones. Sin espacios. Sin mayúsculas.

• Bien: hotspot-collector, code-review, ai-proofreading
• Mal: Hotspot Collector, codeReview, AI_Proofreading

Creando Tu Primera Skill

Aquí está mi consejo más importante: No necesitas escribir Skills tú mismo.

Déjame explicarte. El valor de una Skill radica en lo que encapsula — tu flujo de trabajo, tu experiencia, tu SOP. Estos provienen de ti, descubiertos a través del trabajo real. ¿Pero transformar eso en un archivo SKILL.md correctamente formateado? Deja que la IA haga eso.

Lo que necesitas hacer:

1. Piensa claramente qué problema quieres resolver
2. Aclara tu flujo de trabajo
3. Proporciona suficiente contexto y materiales de referencia

Luego dile a Claude: "Ayúdame a crear una Skill para hacer XXX". Generará archivos correctamente formateados para ti.

Paso a Paso: Un Ejemplo Simple

Vamos a crear una skill que le enseñe a Claude a explicar código usando diagramas visuales y analogías.

---
name: explain-code
description: Explica código con diagramas visuales y analogías. Usar cuando se explica cómo funciona el código, enseñando sobre una base de código, o cuando el usuario pregunta "¿cómo funciona esto?"
---

When explaining code, always include:

1. **Start with an analogy**: Compare the code to something from everyday life
2. **Draw a diagram**: Use ASCII art to show flow, structure, or relationships
3. **Walk through the code**: Explain step-by-step what happens
4. **Highlight a gotcha**: What's a common mistake or misconception?

Keep explanations conversational. For complex concepts, use multiple analogies.

Dónde Viven las Skills

La ubicación determina el alcance:

Usando el skill-creator Oficial

Anthropic proporciona una skill específicamente para crear skills. Meta, ¿verdad?

Instálala diciéndole a Claude:

Install this skill, project address is: https://github.com/anthropics/skills/tree/main/skills/skill-creator

Una vez instalado, simplemente puedes decir: "Ayúdame a crear una skill para revisar artículos" y Claude usará el skill-creator para generar todo correctamente.

Transformando Todo GitHub en Tu Arsenal Personal

Aquí es donde las cosas se ponen emocionantes. Esta es la técnica que cambió por completo mi forma de pensar sobre las capacidades de la IA.

Aquí está la idea: En treinta años de Internet, innumerables desarrolladores brillantes han resuelto casi todos los problemas que puedas imaginar. Han construido herramientas, las han hecho de código abierto y las han puesto a disposición de cualquiera. ¿El único problema? La mayoría de estas herramientas requieren despliegue, operaciones de línea de comandos, configuración del entorno — barreras que bloquean a los usuarios comunes.

Las Skills pueden disolver esas barreras.

El Concepto Central

Debido a que las Skills pueden empaquetar scripts e instrucciones juntos, puedes encapsular proyectos de código abierto completos en capacidades invocables. El código probado en batalla que ha sido refinado por miles de usuarios a lo largo de los años se convierte en parte de tu kit de herramientas de IA.

Ejemplo Real: Descarga de Videos

Déjame mostrarte un ejemplo real. Digamos que a menudo necesitas descargar videos de YouTube, Bilibili y otras plataformas.

Paso 1: Encuentra el proyecto adecuado. Pregúntale a cualquier IA: "¿Hay un proyecto de código abierto en GitHub que descargue videos de varios sitios web?"

Te señalará yt-dlp — un proyecto legendario con más de 143,000 estrellas que soporta miles de sitios web.

Paso 2: Empaquétalo como una Skill.

Help me package this open source tool https://github.com/yt-dlp/yt-dlp into a Skill, so that whenever I give a video link, it can help me download the video.

Paso 3: Deja que Claude planifique. Usa el modo Plan primero. Claude analizará el proyecto, entenderá sus capacidades y hará preguntas aclaratorias sobre tus preferencias.

Paso 4: Construye y prueba. Cambia al modo de desarrollo. En unos minutos, tendrás una Skill de descarga de videos funcional.

Paso 5: Itera basado en la primera ejecución. La primera vez que uses cualquier skill que envuelva una herramienta de código abierto, encontrarás problemas. YouTube tiene mecanismos anti-rastreo. Es posible que necesites instalar dependencias. Documenta estas experiencias y dile a Claude que actualice la skill.

Update all these experiences into the video-downloader skill. Remember the Cookie requirement, the dependency installation, everything we just figured out.

¿La próxima vez? Abre y descarga. Instantáneo.

Más Ideas para GitHub-to-Skills

Estos son solo la punta del iceberg. GitHub aloja millones de proyectos — décadas de brillantez humana, disponibles gratuitamente.

No necesitas tres cabezas y seis brazos. No necesitas cuernos en la cabeza. Detrás de ti está el conocimiento acumulado de toda la humanidad durante las últimas décadas. Siempre que lo quieras — puede ser tuyo para comandar.

Construyendo un Sistema de Gestión de Skills Auto-Evolutivo

Ahora entramos en territorio que me tomó dos días completos descubrir. Aquí es donde las Skills pasan de ser "herramientas útiles" a "capacidades vivas y crecientes".

El problema: Las Skills empaquetadas de proyectos de GitHub necesitan mantenimiento. Los repositorios originales se actualizan. Ocurren correcciones de errores. Aparecen nuevas características. Mientras tanto, has estado usando tu skill y acumulando experiencia — "este parámetro funciona mejor", "agrega esta bandera para evitar ese error". ¿Cómo gestionas todo esto?

La Solución de Tres Piezas

Construí (con la ayuda de la IA) un trío de skills que trabajan juntas para resolver esto:

El Problema del Control de Versiones

Aquí hay un conflicto con el que seguía tropezando: Cuando GitHub se actualiza, quiero obtener el código más reciente y regenerar el SKILL.md. Pero también he estado iterando en mi skill basándome en la experiencia de uso — ajustes, correcciones, preferencias. Estas modificaciones también viven en SKILL.md.

Dos fuerzas, ambas modificando el mismo archivo, con objetivos completamente diferentes. Desastre esperando a suceder.

La Solución: evolution.json

La idea: Separar preocupaciones.

Las actualizaciones de GitHub continúan regenerando el archivo SKILL.md base. Pero toda la experiencia acumulada se almacena en un archivo evolution.json separado. Piénsalo como un guardado de juego. No importa a qué versión se actualice el juego principal, tu archivo de guardado preserva tu progreso.

Cuando SKILL.md es sobrescrito por una nueva versión, evolution.json juega su papel — reinyectando la sabiduría acumulada de nuevo en la skill fresca.

yt-dlp-skill/
├── SKILL.md           # Instrucciones base (se pueden regenerar)
├── evolution.json     # Experiencia acumulada (preservada)
└── scripts/
    └── download.sh    # Script de ejecución

El Volante de Gestión

Con estas tres piezas en su lugar, la gestión de skills se convierte en un ciclo de auto-refuerzo:

1. Crear nuevas skills desde GitHub usando github-to-skills (con identidad incrustada)
2. Usar skills en el trabajo diario, encontrando casos extremos y soluciones
3. Evolucionar skills automáticamente a través de skill-evolution-manager (soluciones capturadas)
4. Actualizar skills base cuando los repos de GitHub se actualizan a través de skill-manager
5. Fusionar datos de evolución de nuevo en las skills actualizadas (experiencia preservada)

El resultado: Skills que realmente aprenden y mejoran. No metafóricamente — realmente. Cada vez que las usas y resuelves un problema, se vuelven más inteligentes.

He hecho de código abierto este trío en https://github.com/KKKKhazix/Khazix-Skills. No es perfecto, pero funciona. Y apunta hacia algo poderoso: las skills del mañana no serán documentos estáticos. Serán sistemas vivos.

La Lista del Tesoro de las 14 Skills Oficiales

Antes de construir las tuyas, conoce lo que ya está disponible. Anthropic mantiene un repositorio oficial de skills que cubre las necesidades comunes maravillosamente.

Todas las skills en: https://github.com/anthropics/skills

Skills de Documentos (Código Cerrado)

Estas impulsan la generación de documentos que ves en Claude.ai:

Skills de Desarrollo (Apache 2.0 Open Source)

Skills Creativas

Skills de Comunicación y Meta

Métodos de Instalación

Método 1: Lenguaje Natural

Simplemente dile a Claude: "Install this skill, project address is: [GitHub URL]"

Método 2: Mercado de Plugins

# Añadir repo oficial como marketplace
/plugin marketplace add https://github.com/anthropics/skills

# Instalar skills
/plugin install
# Tab para Marketplace, selecciona el paquete deseado

Método 3: Arrastrar Manualmente

Descarga la carpeta de la skill y colócala en tu directorio de skills (~/.claude/skills/ para personal, .claude/skills/ para específico del proyecto).

El Arte de Diseñar Skills - Un Desglose Profundo

Habiendo hecho diseño de UX durante años, encuentro las skills de diseño oficiales particularmente fascinantes. Déjame desglosar las técnicas que las hacen funcionar tan bien. Estos patrones se aplican mucho más allá del diseño — son plantillas para cualquier skill de alta calidad.

Técnica 1: Elevar el Techo

La skill algorithmic-art no comienza con "ayúdame a dibujar con p5.js". Comienza con:

"Las filosofías algorítmicas son movimientos estéticos computacionales que luego se expresan a través del código."

Esto eleva la tarea de "generar una obra" a "crear un género estético más el sistema de algoritmos correspondiente". Le recuerda al modelo que la salida debe ser sistemática, no una inspiración única.

Técnica 2: Estructura de Dos Etapas

Ambas skills de diseño utilizan un enfoque de dos etapas:

1. Primero, crear la Filosofía (marco conceptual en .md)
2. Luego, expresarla visualmente (implementación real)

Esto fuerza la abstracción antes de la implementación. El modelo no puede caer en óptimos locales de "escribir código, ajustar valores". El concepto es lo primero; el código es solo expresión.

Técnica 3: Plantillas Poéticas + Ingeniería

La skill algorithmic-art proporciona estructura para la escritura de filosofía:

Express how this philosophy manifests through:
- Computational processes and mathematical relationships
- Noise functions and randomness patterns
- Particle behaviors and field dynamics
- Temporal evolution and system states
- Parametric variation and emergent complexity

Nota: cada punto es tanto lenguaje estético COMO objeto técnico. "Funciones de ruido" se mapea directamente al código. "Comportamientos de partículas" es implementable. Esto une la visión y la ejecución.

Técnica 4: Semillas de Concepto

Una idea brillante de las skills oficiales:

"El concepto es una referencia sutil, de nicho, incrustada dentro del propio algoritmo — no siempre literal, siempre sofisticada. Piensa como un músico de jazz citando otra canción a través de la armonía algorítmica."

Los temas de usuario deben estar incrustados en parámetros, comportamientos, patrones — no escritos en la pantalla. Rinde homenaje, pero escóndelo profundamente. Los que saben lo sentirán; los que no, solo pensarán que se ve bien.

Técnica 5: Plantillas con Zonas de Libertad

Las skills definen claramente qué es FIJO (diseño, marca, controles) y qué es VARIABLE (algoritmo, parámetros, colores). Esto asegura:

• Cada salida tiene una experiencia de UI consistente
• El modelo sabe exactamente dónde puede/no puede modificar
• Reduce las "sorpresas" inesperadas de una interpretación demasiado creativa

Técnica 6: Artesanía como Lista de Verificación

La skill canvas-design codifica estándares profesionales como reglas verificables:

• Nada se cae de la página
• Nada se superpone
• Los márgenes adecuados no son negociables
• El texto es siempre mínimo y visual-primero

Esto traduce el conocimiento profesional tácito en restricciones de comportamiento explícitas. El modelo puede verificar su propio trabajo contra criterios concretos.

Técnica 7: Resta, No Adición

El paso de refinamiento final es genial:

"Para refinar el trabajo, evita agregar más gráficos; en su lugar, refina lo que se ha creado. Si el instinto es llamar a una nueva función o dibujar una nueva forma, DETENTE."

Esto codifica la "artesanía del último 10%" que separa al aficionado del profesional. Cuando el instinto dice "añadir más", pregunta en su lugar: ¿Qué se puede eliminar? ¿Qué se puede alinear, fusionar, fortalecer?

Diseñando la Arquitectura de tu Biblioteca de Skills

Con docenas de skills, la organización importa. Así es como pienso sobre la estructuración de una biblioteca de skills que escala.

¿Por Qué Dividir las Skills?

La gente a menudo pregunta: "¿No puedo simplemente escribir una gran skill que haga todo?"

No. Tres razones:

Patrones de Tipo de Skill

He encontrado cuatro patrones que cubren la mayoría de los casos de uso:

Mi Sistema de Skills de Escritura

Como ejemplo concreto, así es como he estructurado las skills para escribir:

P0 Skills Nucleares (Cada Artículo)

• ai-proofreading: Proceso de tres pasadas para reducir la tasa de detección de IA. Activador: "proofread", "too AI"
• image-illustration: Generar imagen + subir a hosting + devolver markdown. Activador: "illustrate", después de la revisión

P1 Skills Regulares (Mayoría de los Artículos)

• topic-generator: Generar ideas de temas basadas en tendencias. Activador: "give me topics"
• long-to-x: Convertir formato largo a hilos de Twitter. Activador: "convert to X content"
• research-collector: Recopilar y organizar materiales de investigación. Activador: "research [topic]"

P2 Skills Ocasionales

• headline-generator: Crear títulos llamativos. Activador: "title ideas"
• seo-optimizer: Optimizar para motores de búsqueda. Activador: "SEO", "optimize for search"

Manejo de Errores en Skills

El Ecosistema de Skills en Explosión

Cuando miré por primera vez las Skills el mes pasado, encontré un puñado de repositorios. ¿Ahora? El ecosistema ha explotado. Hay mercados dedicados, directorios curados y decenas de miles de skills contribuidas por la comunidad.

Puntos de Partida Oficiales

Documentación de Anthropic: https://code.claude.com/docs/en/skills

Guías claras y paso a paso para crear y usar skills.

Repositorio Oficial: https://github.com/anthropics/skills

Las 14 skills oficiales más ejemplos.

Estándar de Agent Skills: https://agentskills.io

La especificación del estándar abierto. Si quieres entender la especificación técnica completa, comienza aquí.

Mercados Comunitarios

Colecciones Curadas

smithery.ai/skills — No muchas, pero cada una es seleccionada por calidad.

awesome-claude-skills en GitHub — Una lista curada manualmente. Alta calidad, actualizada frecuentemente.

Directorios Multi-herramienta

mcpservers.org/claude-skills — Pone servidores MCP y Claude Skills juntos. Perspectiva única sobre el ecosistema.

claudemarketplaces.com — Un directorio de mercados. El "mercado de mercados".

Patrones Avanzados y Técnicas Pro

Para aquellos listos para profundizar, aquí hay patrones que he descubierto a través del uso extensivo.

Inyección Dinámica de Contexto

La sintaxis !`command` ejecuta comandos de shell antes de que el contenido de la skill llegue a Claude. La salida reemplaza el marcador de posición.

---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...

Ejecución Forked (Integración de Subagente)

Agrega context: fork para ejecutar una skill en aislamiento. El contenido de la skill se convierte en el prompt que impulsa un subagente.

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:

1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references

Sustitución de Argumentos

Pasa valores dinámicos a las skills usando $ARGUMENTS o posicionales $0, $1, etc.

---
name: migrate-component
description: Migrate a component from one framework to another
---

Migrate the $0 component from $1 to $2.
Preserve all existing behavior and tests.

Modo Solo Lectura

Usa allowed-tools para restringir lo que Claude puede hacer cuando una skill está activa:

---
name: safe-reader
description: Read files without making changes
allowed-tools: Read, Grep, Glob
---

Explore and understand the codebase without modifying anything.

Generación de Salida Visual

Las Skills pueden generar archivos HTML interactivos que se abren en tu navegador. Este patrón funciona para:

• Visualizaciones de base de código
• Gráficos de dependencia
• Informes de cobertura de pruebas
• Diagramas de esquema de base de datos
• Cualquier dato complejo que se beneficie de la exploración interactiva

El script incluido hace el trabajo pesado; Claude orquesta. Los usuarios obtienen una salida visual rica sin ningún paso manual.

Registro de Sesión (Session Logging)

Usa ${CLAUDE_SESSION_ID} para operaciones específicas de la sesión:

---
name: session-logger
description: Log activity for this session
---

Log the following to logs/${CLAUDE_SESSION_ID}.log:

$ARGUMENTS

Activador de Pensamiento Extendido

El Estado de la Creación

Quiero terminar con algo personal.

Cada vez que trabajo en Skills, me transporto de regreso al verano de 2013. Acababa de terminar los exámenes de ingreso a la escuela secundaria y compré una computadora portátil con mis ahorros. Pasé todo ese verano jugando con mods para Skyrim — descargándolos, combinándolos, ajustando archivos de configuración, viendo mi juego transformarse en algo completamente mío.

Eso era pura alegría de creación. No consumir contenido. No desplazarse por feeds. Realmente construir algo, personalizar algo, hacer algo mío.

Las Skills traen esa sensación de vuelta.

El estado más genial de la mentoría no es tener a alguien elocuente que necesita que lo lleven de la mano constantemente. Es entregarles un conjunto de manuales y verlos hojear, ejecutar, autoevaluarse e iterar de forma independiente. Dices menos; ellos entregan más.

Las Skills son exactamente esto.

Hoy podrías instalar skill-creator y solidificar una acción común — tal vez filtrar puntos calientes para temas, convertir registros de errores en planes de reparación o convertir enlaces en resúmenes. Solo uno.

Cuando se ejecute con éxito, entenderás el valor de la reutilización.

Mañana querrás un segundo. Al día siguiente, querrás mover todos tus procesos dentro.

En ese punto, entras en un estado diferente.

Libertad. El estado de la creación.

Esos brillantes proyectos de código abierto en GitHub — décadas de sabiduría humana, compartida libremente. Debido a las Skills, debido a los Agentes, cada persona común ahora puede comandar ese poder.

No necesitas tres cabezas y seis brazos. No necesitas habilidades sobrenaturales. Detrás de ti está el conocimiento acumulado de la humanidad. Siempre que lo quieras — es tuyo.

Si te compararas ahora contigo mismo hace tres años, ¿habría siquiera una comparación? Mira lo que puedes hacer hoy. Mira dónde se han expandido tus límites de capacidad.

Esta era brillante y magnífica que puede convertir a cualquiera en un superhumano — ¿no te emociona?