Skills Agentes

Cómo encontrar e instalar Claude Skills desde GitHub

Dónde están las Claude Skills oficiales y de comunidad en GitHub, cómo instalarlas con un comando y qué revisar antes de confiar en una de terceros.

Publicado
Tiempo de lectura
9 min de lectura
Temas
skills · claude-code · github

TL;DR

  • Skills oficiales: github.com/anthropics/skills - el repositorio de Anthropic con skills de documentos y ejemplos de referencia.
  • Skills de comunidad: miles de repositorios etiquetados con el topic claude-code-skills en GitHub, indexados en nuestro directorio de skills.
  • Cómo se instalan: con /plugin install [skill]@[repo] desde Claude Code, o copiando la carpeta de la skill a ~/.claude/skills/ (global) o .claude/skills/ (proyecto).
  • Seguridad: las skills de comunidad pueden ejecutar comandos shell, leer archivos y hacer peticiones externas - revisa siempre el SKILL.md y la carpeta scripts/ antes de instalar.

Qué son las Claude Skills y por qué viven en GitHub

Las Claude Skills son carpetas de instrucciones que Claude carga dinámicamente cuando detecta que una tarea encaja con su descripción. Cada skill se estructura en torno a un archivo SKILL.md - con frontmatter YAML (name, description, allowed-tools) y el cuerpo de instrucciones - más carpetas opcionales: references/ para documentación, scripts/ para código ejecutable y templates/ para archivos base.

GitHub es el ecosistema natural de estos repositorios porque permite versionar las instrucciones, colaborar en su mejora y distribuirlas mediante comandos de instalación directa. Anthropic publica sus skills oficiales ahí, y la comunidad replica el modelo: un repositorio por colección, etiquetado con el topic claude-code-skills para que sea descubrible.


Los repositorios principales de Claude Skills en GitHub

anthropics/skills - el repositorio oficial

Instala las skills de documentos con:

/plugin install document-skills@anthropic-agent-skills

El repositorio anthropics/skills contiene las implementaciones oficiales de Anthropic: docx, xlsx, pdf, pptx y frontend-design, que genera interfaces web con criterios de tipografía, color y jerarquía visual. También incluye skill-creator, que guía paso a paso la creación de nuevas skills.

Para añadir el repositorio completo como marketplace de plugins:

/plugin marketplace add anthropics/skills

Dirigido a: cualquier developer que trabaje con documentos de oficina o necesite una base verificada por Anthropic.


obra/superpowers - el framework de referencia

/plugin install superpowers@obra

obra/superpowers no es solo una colección de skills: es un framework metodológico para desarrollo de software con Claude Code, con skills como writing-plans, systematic-debugging y test-driven-development. Define un flujo de trabajo completo - desde el diseño hasta el despliegue - y lo distribuye vía el marketplace oficial de plugins.

Dirigido a: developers que quieren imponer una metodología consistente en proyectos de software con Claude Code.


Grandes catálogos de comunidad

Además de los dos repositorios oficiales, varios repositorios de comunidad agregan cientos de skills en un solo lugar en vez de publicar una sola:

git clone https://github.com/alirezarezvani/claude-skills
git clone https://github.com/kursku/skills

alirezarezvani/claude-skills agrupa 380 skills en 20 dominios (engineering, marketing, C-level) con soporte declarado para 13 plataformas. kursku/skills va más allá de las 2.300 skills catalogadas. Ninguno de los dos está verificado por Anthropic - aplica los mismos cinco criterios de la siguiente sección antes de instalar cualquier skill que traigan.

Fuera de estos grandes catálogos, la comunidad publica además cientos de repositorios más pequeños en dominios específicos - marketing, revisión de código, DevOps, diseño. En vez de auditar cada uno manualmente, nuestro directorio de skills los indexa todos con instalaciones reales, actividad del repositorio y coste en contexto, y agrupa los repos con más de una skill en el listado de packs. Para una selección ya filtrada por criterios objetivos, consulta las mejores skills para Claude.


Cómo instalar una skill desde GitHub

Paso 1 - Encuentra el repositorio

Busca en github.com/anthropics/skills para skills oficiales o en el directorio de skills para navegar la comunidad con filtros por categoría y nivel técnico. También puedes buscar directamente en GitHub con el topic claude-code-skills.

Paso 2 - Instala con el comando correspondiente

Para skills del marketplace oficial:

/plugin install [nombre-skill]@anthropic-agent-skills

Para instalación manual (cualquier repositorio):

# Global (todos los proyectos)
mkdir -p ~/.claude/skills/nombre-skill
cp SKILL.md ~/.claude/skills/nombre-skill/

# Por proyecto (se sube a git)
mkdir -p .claude/skills/nombre-skill
cp SKILL.md .claude/skills/nombre-skill/

Paso 3 - Verifica la instalación

claude skills list

La salida muestra todas las skills activas con su nombre y descripción. Si una skill no aparece, comprueba que el SKILL.md está en la ruta correcta y que el frontmatter YAML es válido.

Paso 4 - Dónde se guardan las skills

Ruta Alcance Se sube a git
~/.claude/skills/ Personal, todos los proyectos No
.claude/skills/ Solo el proyecto actual

Límite de contexto: 15.000 caracteres para la lista completa de skills activas. Mantén cada SKILL.md por debajo de 500 líneas; mueve el contenido extenso a references/ y referéncialo desde el archivo principal. Claude usa carga progresiva: primero nombre y descripción, luego el SKILL.md completo, y solo si es necesario los scripts y referencias. Más detalle sobre este coste en cuántos tokens consume una skill.


Cómo evaluar una skill antes de instalarla

Revisa estos cinco criterios antes de ejecutar cualquier comando de instalación:

  1. Instalaciones y actividad real - una skill sin uso verificable y sin commits recientes tiene menor probabilidad de estar mantenida.
  2. Fecha del último commit - un repositorio sin actividad en más de seis meses puede no ser compatible con las versiones actuales de Claude Code.
  3. Lee el SKILL.md completo antes de instalar - la descripción en el frontmatter determina cuándo Claude activa la skill. Si es vaga o genérica, se activará en contextos incorrectos.
  4. Revisa la carpeta scripts/ - los scripts pueden ejecutar comandos shell, leer archivos del sistema y hacer peticiones a servicios externos. Si el código no es legible o llama a URLs desconocidas, no instales la skill.
  5. Prueba en un proyecto de prueba antes de producción - instala la skill en .claude/skills/ de un repositorio vacío y ejecuta la misma tarea tres veces. Si los resultados varían significativamente, la skill necesita mejoras.

Seguridad al instalar skills de la comunidad

Las skills de comunidad no están verificadas por Anthropic. Antes de instalar cualquier skill de un repositorio externo, entiende qué puede hacer:

Qué pueden hacer las skills de comunidad:

  • Leer archivos del sistema de archivos local
  • Ejecutar comandos shell mediante el campo allowed-tools: [Bash]
  • Hacer peticiones HTTP a servicios externos
  • Acceder a variables de entorno

El campo allowed-tools controla los permisos. Una skill con allowed-tools: [Read, Grep, Glob] solo puede leer archivos - no puede modificarlos ni ejecutar comandos. Una con allowed-tools: [Bash(gh *)] puede ejecutar comandos de GitHub CLI. Revisa este campo como primer filtro de seguridad.

Señales de alerta en una skill de comunidad:

  • Scripts con llamadas a URLs externas no documentadas
  • allowed-tools: [Bash] sin restricciones de subcomando
  • SKILL.md sin frontmatter o con descripción vacía
  • Repositorio sin historial de commits visible

Las skills oficiales del repositorio anthropics/skills pasan por revisión interna de Anthropic. Las skills de comunidad no tienen ningún proceso de verificación - la responsabilidad de la auditoría es tuya. Para dar el paso siguiente y conectar la skill con sistemas externos, revisa también los mejores servidores MCP.


Cómo crear y publicar tu propia skill en GitHub

  1. Detecta la repetición - si escribes el mismo contexto o instrucciones tres o más veces en conversaciones distintas, tienes un candidato a skill.
  2. Crea la carpeta - en ~/.claude/skills/nombre-skill/ para desarrollo personal, o en .claude/skills/nombre-skill/ si es específica de un proyecto.
  3. Escribe el SKILL.md - empieza con la versión mínima: frontmatter con name, description precisa y allowed-tools restrictivos. El cuerpo cubre solo el caso común; los casos edge van en references/.
  4. Prueba con casos reales - compara el output con y sin la skill activa. Si la diferencia no es visible, la descripción o las instrucciones son demasiado vagas.
  5. Itera sobre los fallos - si Claude ignora una instrucción tres veces o más, añade la corrección directamente al SKILL.md.
  6. Publica en GitHub con el topic claude-code-skills - añade el topic al repositorio para que aparezca indexado en directorios de comunidad, incluido el nuestro.

Preguntas frecuentes

¿Cuántas skills puedo instalar a la vez?

El límite práctico lo impone el contexto: 15.000 caracteres para la lista completa de skills activas (nombre + descripción de todas). Con descripciones concisas de 2-3 líneas, caben entre 20 y 40 skills antes de saturar el contexto. La solución es mantener skills globales en ~/.claude/skills/ solo para flujos transversales, y skills de proyecto en .claude/skills/ para lo específico de cada repositorio.

¿Las skills de GitHub son gratuitas?

Sí - los repositorios de skills son open source y de acceso libre. Lo que requiere suscripción es Claude Code: necesitas una cuenta activa para que las skills funcionen. Las skills en sí no tienen coste adicional.

¿Funcionan las skills de Claude Code en Cursor o Copilot?

Sí. Desde diciembre de 2025, GitHub Copilot detecta automáticamente el directorio .claude/skills/ de un repositorio y carga las skills relevantes - funciona en Copilot coding agent, Copilot CLI y agent mode en VS Code. Cursor también lee las skills del directorio .claude/skills/ del proyecto. Una skill bien escrita funciona en Claude Code, Cursor y Copilot sin modificaciones.

¿Qué diferencia hay entre una skill y un MCP server?

Una skill es un paquete de instrucciones: le dice a Claude cómo hacer algo - qué pasos seguir, qué criterios aplicar, qué formato usar. No conecta con sistemas externos por sí sola. Un MCP server es un conector de herramientas: le da a Claude acceso a sistemas externos - bases de datos, APIs, sistemas de ficheros remotos. La combinación de ambos - skill con instrucciones + MCP server con acceso - es el patrón más potente para agentes IA en producción.

¿Cómo sé si una skill está funcionando?

Ejecuta la misma tarea tres veces con la skill activa. Si cada ejecución produce resultados significativamente distintos, la skill tiene un problema de especificidad - las instrucciones son ambiguas o la descripción no la activa en el contexto correcto. Si el output es idéntico al que Claude produce sin la skill, el problema suele estar en el frontmatter: la descripción no es lo bastante precisa para que Claude la seleccione.


Fuentes útiles

Para montar un agente completo desde cero con skills y MCP servers, sigue cómo crear un agente de IA gratis o revisa el coste real en contexto de una skill antes de activar muchas a la vez.

Todos los artículos del blog