Cómo configurar Claude Code con skills personalizadas: el método Karpathy para empresas
El repositorio andrej-karpathy-skills se ha convertido en el número uno de GitHub Trending en abril de 2026. No es un framework, no es una librería, no es una app. Es un conjunto de instrucciones —un archivo CLAUDE.md y una carpeta de skills— que le dice a Claude Code cómo trabajar de forma disciplinada.
Y es exactamente lo que llevamos meses usando en nuestra agencia para gestionar proyectos de clientes en Tenerife.
Este artículo explica qué son las skills de Claude Code, por qué el método de Karpathy funciona, y cómo puedes configurar tu propio sistema de agente IA personalizado para tu empresa. Sin hype, con ejemplos reales del uso que hacemos en YAG Comunicación.
Qué es Claude Code y por qué es diferente de ChatGPT
Claude Code es una herramienta de terminal desarrollada por Anthropic que permite a Claude —el modelo de lenguaje— interactuar directamente con tu código, tus archivos y tu sistema. A diferencia de ChatGPT (que opera en una interfaz web aislada), Claude Code:
- Lee y entiende tu codebase completo: no le pegas fragmentos de código; Claude Code analiza todo tu proyecto automáticamente.
- Ejecuta tareas multi-paso: puede planificar una secuencia de cambios, ejecutarlos, verificar que funcionan y corregir errores por sí solo.
- Gestiona Git nativamente: crea commits, branches, pull requests y revisa diffs como un desarrollador más del equipo.
- Se personaliza con instrucciones persistentes: aquí es donde entran las skills y el CLAUDE.md.
Para una agencia web que gestiona 10-20 proyectos simultáneos, esto significa pasar de "pedirle ayuda a la IA" a "delegarle tareas completas con supervisión".
Si quieres entender el contexto más amplio de cómo la IA transforma el trabajo en empresas de Canarias, el artículo sobre inteligencia artificial para pymes en Tenerife da la visión general.
Qué son las Skills: instrucciones modulares para tu agente IA
Una "skill" de Claude Code es un directorio que contiene:
- Un archivo
SKILL.md: con instrucciones en lenguaje natural que le dicen a Claude cómo realizar una tarea específica. - Archivos de soporte: scripts, templates, documentos de referencia que el agente necesita para ejecutar la tarea.
Cuando colocas estas skills en la carpeta .claude/skills/ de tu proyecto, Claude Code las carga automáticamente y puede usarlas cuando detecta que son relevantes para la tarea que le pides.
Ejemplo concreto: skill de animaciones GSAP
En nuestra agencia, una de las skills que usamos constantemente es la de estandarización de animaciones. Todos nuestros sitios web usan GSAP (GreenSock Animation Platform) en lugar de framer-motion o CSS puro. La skill le dice a Claude:
# Skill: GSAP Animation Standard
## Reglas
- SIEMPRE usar `gsap` y `@gsap/react` para animaciones
- NUNCA usar framer-motion, ni CSS transitions para componentes complejos
- Usar el hook `useGSAP` de @gsap/react (NO useEffect con gsap.to)
- ScrollTrigger para animaciones on-scroll
- Timeline para secuencias coordinadas
## Patrón estándar
[código de ejemplo con useGSAP]
Cuando le pedimos a Claude Code que añada animaciones a un componente, automáticamente sigue este estándar sin que tengamos que explicarlo cada vez.
El método Karpathy: los 4 principios
Andrej Karpathy —ex director de IA en Tesla y una de las voces más respetadas en la industria— ha compartido su experiencia usando Claude Code de forma intensiva. Sus observaciones se han cristalizado en cuatro principios que la comunidad ha adoptado masivamente:
1. Pensar antes de codificar
El agente debe hacer preguntas de clarificación cuando la tarea es ambigua, en lugar de asumir lo que quieres y producir código que no resuelve el problema correcto. En la práctica, esto se traduce en una instrucción en CLAUDE.md:
"Cuando una tarea sea ambigua, pregunta al usuario antes de empezar. No asumas el alcance ni las dependencias."
2. Simplicidad primero
Escribir el código mínimo necesario. Evitar sobre-ingeniería, abstracciones prematuras y complejidad innecesaria. Esto previene el problema más común cuando un agente IA genera código: produce soluciones técnicamente correctas pero innecesariamente complejas que luego nadie puede mantener.
3. Cambios quirúrgicos
Solo modificar lo que es necesario para la tarea. No refactorizar archivos que no están directamente relacionados, no "mejorar" código que funciona, no cambiar estilos o convenciones existentes sin permiso explícito. Este principio es crítico cuando Claude Code trabaja en proyectos de clientes en producción.
4. Ejecución orientada a objetivos
Definir criterios de éxito claros y ejecutar hasta conseguirlos. Si un test falla, corregir y volver a probar. Si un build no compila, diagnosticar y arreglar. No detenerse a la primera dificultad.
Cómo configurar tu propio CLAUDE.md
El archivo CLAUDE.md se coloca en la raíz de tu proyecto (o de tu repositorio) y actúa como las "instrucciones permanentes" que Claude Code sigue en cada sesión. Es el equivalente a darle a un nuevo miembro del equipo un manual de onboarding antes de que toque el código.
Estructura que usamos en nuestra agencia
## §1. IDENTIDAD
Eres un desarrollador senior trabajando para [nombre empresa].
Stack: Next.js 15, TypeScript, GSAP, Vanilla CSS (HSL vars).
Objetivo: máxima calidad de código, SEO perfecto, rendimiento premium.
## §2. REGLAS DE CÓDIGO
- TypeScript estricto, NO any
- CSS con variables HSL, NO Tailwind (salvo petición expresa)
- Componentes funcionales con hooks
- Commits descriptivos en español
## §3. PROYECTOS ACTIVOS
[Lista de proyectos con sus particularidades]
## §4. PROHIBICIONES
- NUNCA hardcodear credenciales
- NUNCA usar APIs de pago sin autorización
- NUNCA modificar producción sin verificación previa
## §5. FLUJO DE TRABAJO
1. Leer la tarea completa
2. Verificar el estado actual del proyecto
3. Planificar cambios
4. Implementar de forma incremental
5. Verificar que funciona
6. Documentar lo hecho
Adaptación por tipo de empresa
El CLAUDE.md que usamos para un despacho de abogados es completamente diferente al de una empresa de turismo. Algunos ejemplos de adaptación:
Para una asesoría legal (como Álamo & Antúnez):
- Instrucciones de confidencialidad estrictas
- Prohibición de generar asesoramiento legal (solo borradores informativos)
- Tono formal y técnico
- Esquemas legales específicos (FAQPage, LegalService)
Para un negocio de hostelería:
- Tono cercano y turístico
- Instrucciones de gestión de reseñas multiidioma
- Schema de LocalBusiness con geo-targeting
- Integración con Google Business Profile
Para una empresa de construcción (como Íkaro):
- Portfolio visual con animaciones premium
- Llamadas a acción orientadas a presupuesto
- Galería de proyectos con antes/después
- Schema de ContractorService
Skills que toda empresa debería tener
Basándonos en nuestra experiencia con clientes de diferentes sectores, estas son las skills que aportan valor inmediato:
1. Skill de SEO On-Page
Instrucciones para que el agente optimice automáticamente:
- Title tags con keyword principal y modificadores
- Meta descriptions persuasivas (155 caracteres)
- Estructura de headings jerárquica (H1 único)
- Schema markup según tipo de página
- Internal linking estratégico
- Checklist de 7 puntos antes de publicar
2. Skill de generación de contenido
Reglas para que el contenido generado sea:
- Original y basado en experiencia real (no genérico)
- Con tono específico de la marca
- Con datos verificables y enlaces internos
- Optimizado para SEO sin sacrificar naturalidad
- Con CTA concreto al final
3. Skill de seguridad
Instrucciones para que el agente:
- Nunca exponga credenciales en commits
- Verifique el host real de cada sitio antes de hacer cambios
- Use variables de entorno para todo dato sensible
- Rechace tareas que puedan comprometer datos de cliente
4. Skill de deploy y CI/CD
Automatización de:
- Build verification antes de deploy
- Comprobación de rutas y assets
- Rollback automático si falla
- Notificación post-deploy
Por qué esto es un servicio que puedes vender
Aquí es donde la oportunidad de negocio se vuelve concreta. Las skills y el CLAUDE.md no son algo que cada empresa pueda configurar por sí sola. Requieren:
- Conocimiento del stack técnico del cliente: qué tecnologías usa, qué convenciones tiene, qué limitaciones hay.
- Experiencia con agentes IA: saber qué instrucciones son efectivas y cuáles el agente ignora o malinterpreta.
- Contexto de negocio: entender el sector, los clientes del cliente, el tono de marca, las prioridades estratégicas.
Para la mayoría de empresas, especialmente pymes que no tienen un equipo de desarrollo interno, configurar esto es tan complejo como montar un OpenClaw. Es un servicio profesional que aporta valor inmediato y recurrente.
En YAG Comunicación ofrecemos este servicio como un paquete cerrado:
- Auditoría del stack técnico
- Creación de CLAUDE.md personalizado
- 3-5 skills modulares para el workflow del cliente
- Configuración de hooks de seguridad
- Sesión de formación práctica
Si quieres explorar si este servicio tiene sentido para tu empresa, contacta con nosotros y analizamos tu caso.
La tendencia es clara: el desarrollador ya no escribe código, supervisa agentes
Lo que Karpathy ha demostrado —y lo que confirmamos cada día en nuestro trabajo— es que el rol del desarrollador está cambiando fundamentalmente. Ya no se trata de escribir cada línea de código. Se trata de:
- Definir estándares claros (CLAUDE.md, skills)
- Supervisar la ejecución del agente
- Verificar la calidad del output
- Iterar sobre los estándares cuando algo no funciona
Las empresas que adopten este modelo de trabajo más temprano tendrán una ventaja competitiva real: podrán producir más, con menos errores, en menos tiempo. Y las agencias que sepan configurar estos sistemas para sus clientes tendrán un servicio de alto valor que pocas ofrecen.
El repo de Karpathy tiene miles de estrellas porque la comunidad reconoce que este es el futuro. La pregunta no es si las skills de IA llegarán a tu empresa, sino cuándo.
¿Quieres configurar un agente IA personalizado para tu empresa en Canarias? Hablemos. Evaluamos tu stack, tu equipo y tus necesidades, y te proponemos un plan concreto sin compromiso.