Claude Code no se entiende bien si se presenta solo como “un chat que programa”. Su valor aparece cuando se integra con el repositorio, lee instrucciones del proyecto, ejecuta tareas repetibles y usa skills o agentes especializados para trabajar con más contexto. Ahí GitHub deja de ser solo un lugar donde guardar código y se convierte en una fuente de procedimientos, revisiones, automatizaciones y buenas prácticas reutilizables.
Para un perfil técnico, incluso si no es developer puro, la idea es potente: descargar un repositorio, copiar unas instrucciones bien estructuradas y hacer que Claude Code trabaje con ellas dentro de un proyecto real. No hace falta dominar Git a nivel avanzado. Pero sí conviene entender qué se está instalando, dónde se coloca y qué permisos se le están dando al agente.
Anthropic define Claude Code como una herramienta agentic para trabajar desde la terminal, capaz de entender una base de código, editar archivos, ejecutar comandos y apoyarse en extensiones como skills, hooks, subagentes y MCP. Las skills, en concreto, se organizan como carpetas con un archivo SKILL.md, donde se describen instrucciones, metadatos y contexto para que Claude las use cuando corresponde o cuando el usuario las invoca directamente.
La carpeta .claude/ como capa operativa del proyecto
La forma más sencilla de verlo es esta: Claude Code trabaja mejor cuando el proyecto le dice cómo debe comportarse. Ese contexto suele vivir en una carpeta .claude/, con archivos de reglas, skills, agentes y configuración.
Una estructura básica puede ser así:
mi-proyecto/
├── .claude/
│ ├── CLAUDE.md
│ ├── skills/
│ │ ├── security-review/
│ │ │ └── SKILL.md
│ │ └── deploy-checklist/
│ │ └── SKILL.md
│ ├── agents/
│ │ └── code-reviewer.md
│ └── settings.json
├── src/
├── docker-compose.yml
└── README.mdCLAUDE.md funciona como memoria operativa del proyecto: reglas, comandos habituales, arquitectura, convenciones y límites. Las skills son procedimientos reutilizables para tareas concretas. Los agentes permiten definir roles especializados, como un revisor de seguridad, un experto en documentación o un perfil DevOps. settings.json controla aspectos de configuración y permisos.
| Elemento | Función | Uso típico en un entorno técnico |
|---|---|---|
CLAUDE.md | Instrucciones estables del proyecto | Convenciones, comandos de test, arquitectura, estilo de cambios |
skills/ | Tareas reutilizables | Auditoría, despliegue, documentación, revisión de seguridad |
agents/ | Roles especializados | Code reviewer, SRE, analista de logs, auditor de infraestructura |
settings.json | Configuración y permisos | Control de herramientas, hooks, comportamiento local |
SKILL.md | Núcleo de cada skill | Describe cuándo usarla, qué pasos seguir y qué recursos aplicar |
La clave es que una skill no es una extensión mágica. Es un procedimiento escrito. Eso facilita mucho su adopción, pero también obliga a revisarla con cuidado. Si un archivo le dice a un agente que ejecute comandos, modifique ficheros o consulte información sensible, hay que tratarlo con el mismo respeto que a un script.
Git en cinco comandos para trabajar con repositorios de skills
GitHub asusta menos cuando se reduce a un flujo mínimo. Para descargar colecciones, actualizarlas y guardar cambios en un proyecto propio, cinco comandos cubren la mayor parte del trabajo.
| Comando | Qué hace | Ejemplo |
|---|---|---|
git clone | Descarga un repositorio | git clone https://github.com/gsd-build/get-shit-done.git |
git pull origin main | Actualiza el repositorio local | git pull origin main |
git add . | Prepara cambios para guardarlos | git add . |
git commit -m "mensaje" | Crea un punto de control | git commit -m "Añadir skill de revisión" |
git push origin main | Sube cambios a GitHub | git push origin main |
El flujo básico sería: clonar un repositorio, revisar su contenido, copiar lo necesario a .claude/, probarlo en local y guardar la configuración en tu propio repo. No hace falta copiarlo todo. De hecho, suele ser mejor instalar poco y bien.
git clone https://github.com/gsd-build/get-shit-done.gitDespués, en tu proyecto:
mkdir -p .claude/skills
# Copiar solo la skill o carpeta revisada, no toda la colección sin mirar
cp -R ruta/de/la/skill .claude/skills/Y para abrir Claude Code en el proyecto:
cd mi-proyecto
claudeCuatro repositorios útiles para empezar
El ecosistema alrededor de Claude Code está creciendo rápido. Hay colecciones de skills, toolkits, prompts de revisión y sistemas de meta-prompting que ayudan a no partir de cero. La recomendación práctica es usarlos como referencia, no como una descarga masiva que se instala sin revisar.
| Repositorio | Qué aporta | Mejor uso |
|---|---|---|
gsd-build/get-shit-done | Sistema de meta-prompting, context engineering y desarrollo guiado por especificaciones | Mantener foco en tareas largas y reducir pérdida de contexto |
sickn33/antigravity-awesome-skills | Biblioteca amplia de skills para Claude Code y otros agentes de código | Explorar skills por categorías y adaptar las útiles |
rohitg00/awesome-claude-code-toolkit | Colección de agentes, skills, comandos, hooks, plugins y recursos | Descubrir patrones y herramientas del ecosistema Claude Code |
dcarrero/awesome-code-review-prompts | Prompts bilingües para revisión de código con IA | Estandarizar revisiones de seguridad, rendimiento, accesibilidad y calidad |
GetShitDone se presenta como un sistema ligero de meta-prompting y context engineering para Claude Code, OpenCode, Gemini CLI, Codex, Copilot y Antigravity. Su objetivo principal es reducir el context rot, esa pérdida de calidad que aparece cuando una conversación larga empieza a mezclar decisiones, tareas y detalles antiguos.
Antigravity Awesome Skills se orienta a una idea distinta: reunir una biblioteca instalable de skills para asistentes de código. Es útil para ver cómo se empaquetan instrucciones reutilizables y qué categorías de tareas se están cubriendo, desde testing hasta documentación o seguridad.
Awesome Claude Code Toolkit funciona más como mapa del ecosistema. Reúne enlaces a agentes, skills, hooks, MCPs, plugins y configuraciones. Es una buena puerta de entrada para entender qué piezas existen, aunque exige criterio para separar lo útil de lo experimental.
El repositorio dcarrero/awesome-code-review-prompts encaja especialmente bien en equipos técnicos que quieren mejorar revisiones asistidas por IA. Su descripción lo presenta como una colección de prompts maestros para que Claude y otros modelos revisen código en seguridad, rendimiento, accesibilidad, usabilidad y calidad, con enfoque agnóstico y add-ons para múltiples stacks.
Cómo convertir un prompt en una skill útil
Muchos equipos empiezan copiando prompts en un documento. Es normal, pero se queda corto. El salto interesante es convertir esos prompts en skills reutilizables. Por ejemplo, un prompt de revisión de seguridad puede transformarse en una skill llamada security-review, con criterios, pasos, formato de salida y límites claros.
Un ejemplo simplificado de SKILL.md podría ser:
---
name: security-review
description: Revisa cambios de código buscando riesgos de seguridad, validación de entradas, exposición de secretos, permisos excesivos y malas prácticas.
---
# Security Review
Analiza los archivos modificados y revisa:
1. Validación de entradas.
2. Gestión de credenciales y secretos.
3. Control de acceso y autorización.
4. Riesgos de inyección.
5. Dependencias inseguras.
6. Configuraciones peligrosas.
Entrega el resultado en este formato:
- Riesgo
- Archivo afectado
- Severidad
- Explicación
- Recomendación concretaLa ventaja es que el equipo deja de depender de que cada persona recuerde el prompt correcto. La instrucción queda versionada, revisable y compartida dentro del repositorio.
Para administración de sistemas, lo mismo puede aplicarse a revisiones de Terraform, Docker Compose, Kubernetes, scripts Bash, hardening Linux, reglas de firewall, backups, monitorización o documentación de procedimientos.
| Caso de uso | Skill posible | Resultado esperado |
|---|---|---|
| Revisar Terraform | iac-review | Riesgos de seguridad, costes, permisos y cambios destructivos |
| Revisar Docker Compose | compose-audit | Puertos expuestos, volúmenes, secretos, healthchecks |
| Auditar Kubernetes | k8s-review | Recursos, probes, namespaces, RBAC, límites y seguridad |
| Revisar scripts Bash | shell-review | Errores, idempotencia, seguridad, manejo de fallos |
| Documentar un servicio | service-docs | README técnico, arquitectura, comandos y troubleshooting |
| Revisar rendimiento | performance-review | Cuellos de botella, queries, caché y uso de recursos |
Seguridad: el punto que no se puede saltar
El crecimiento de las skills también abre un nuevo riesgo de cadena de suministro. Un estudio reciente sobre SKILL.md advierte de que las skills no son documentación pasiva: sus descripciones e instrucciones pueden influir en qué capacidades encuentra, selecciona y carga un agente. El trabajo analiza ataques semánticos en el ciclo de vida de skills y muestra que metadatos aparentemente inocentes pueden manipular descubrimiento, selección y gobernanza.
La conclusión para un medio tech es clara: instalar skills de GitHub exige revisión. No porque todos los repositorios sean peligrosos, sino porque un agente con permisos puede convertir una instrucción maliciosa o mal diseñada en una acción real.
| Riesgo | Qué puede pasar | Medida prudente |
|---|---|---|
| Instrucciones ocultas | La skill pide acciones que el usuario no espera | Leer todo el SKILL.md antes de usarlo |
| Comandos peligrosos | Borrado, sobrescritura o subida de datos | Probar en repositorios de prueba |
| Permisos excesivos | El agente accede a más de lo necesario | Limitar herramientas y revisar settings.json |
| Dependencias externas | Instalación de paquetes o scripts no auditados | Evitar ejecución automática sin revisión |
| Colecciones masivas | Se instalan skills redundantes o contradictorias | Copiar solo lo necesario |
| Falta de versionado | No se puede volver atrás | Usar Git y commits pequeños |
También hay que evitar la moda de “instalar 200 skills”. Más no siempre es mejor. Demasiadas instrucciones pueden solaparse, generar respuestas contradictorias o hacer que Claude elija procedimientos que no encajan. Una buena configuración suele ser pequeña, clara y orientada a tareas reales del equipo.
Para qué le sirve esto a un equipo de sistemas o DevOps
El caso de uso más interesante no está en pedirle a Claude que escriba una aplicación desde cero, sino en integrarlo en trabajos repetitivos y de revisión. Un equipo de sistemas puede usar Claude Code para preparar checklists de despliegue, revisar cambios de infraestructura, documentar servicios, analizar errores, proponer pruebas, revisar scripts o detectar configuraciones arriesgadas.
Un equipo DevOps puede versionar sus propios procedimientos en .claude/skills/ y convertirlos en parte del repositorio. Así, cada proyecto tiene sus reglas, sus comandos y sus revisiones. Claude no trabaja con instrucciones genéricas, sino con contexto del entorno.
Esto acerca Claude Code a una práctica más profesional: infraestructura y operación asistidas por IA, pero con control humano, trazabilidad y revisión. El agente puede acelerar tareas, pero las decisiones críticas siguen en manos del equipo.
La diferencia entre usar Claude Code como un chat y usarlo como herramienta de ingeniería está en esa capa de procedimientos. GitHub aporta el repositorio. .claude/ aporta el contexto. Las skills aportan método. Y Git permite que todo quede controlado, revisado y reversible.
Preguntas frecuentes
¿Claude Code necesita GitHub para funcionar?
No, pero GitHub facilita mucho la reutilización de skills, agentes, prompts y configuraciones ya versionadas.
¿Qué es exactamente una skill?
Es una carpeta con instrucciones, normalmente en un archivo SKILL.md, que Claude puede usar para ejecutar una tarea concreta de forma consistente.
¿Puedo usar prompts de revisión como skills?
Sí. Un prompt bien estructurado puede convertirse en una skill de revisión de seguridad, rendimiento, accesibilidad, infraestructura o calidad de código.
¿Es seguro instalar skills desde repositorios públicos?
Solo si se revisan antes. Una skill puede influir en el comportamiento del agente, así que debe tratarse como parte de la cadena de suministro del proyecto.
¿Qué aporta awesome-code-review-prompts?
Una colección bilingüe de prompts para revisión de código con IA, útil como base para crear skills internas de seguridad, rendimiento, accesibilidad y calidad.
