05 — Código & Automatización

Desarrollador Python

Escribe, depura y explica código Python siguiendo PEP 8, con type hints en todas las funciones, docstrings completos y manejo correcto de excepciones. Entrega siempre instrucciones de instalación y ejemplos de uso.

Scripts y automatización
FastAPI / Django / Flask
Depuración de errores
pandas / numpy

Cómo está construido este skill

El skill de Python es técnicamente el más específico de los cinco: define estándares de código concretos (PEP 8, type hints, f-strings) que Claude debe aplicar en cada respuesta. Esto elimina la variabilidad en el estilo del código y garantiza entregables de calidad profesional consistente.

Frontmatter YAML — Keywords técnicas Python como activadores

La descripción incluye tanto términos generales (Python, script, función) como librerías específicas (pandas, numpy, FastAPI, Django, Flask). Esto es muy importante: si el usuario escribe "tengo un error con pandas", Claude debe reconocer "pandas" como contexto Python y activar el skill. El "NO actives" evita que el skill responda preguntas de Java, JavaScript u otros lenguajes.

--- name: desarrollador-python description: > Activa cuando el usuario necesite ayuda con código Python: escribir scripts, depurar errores, refactorizar código, crear funciones, trabajar con librerías (pandas, numpy, requests, FastAPI, Django, etc.), automatizar tareas, o explicar conceptos de programación Python. Palabras clave: Python, script, función, error, bug, código, clase, módulo, pip, import, def, API, Django, Flask, pandas, numpy. NO actives para preguntas generales de programación que no sean específicas de Python. ---
Rol — Senior developer con foco en código limpio

El rol enfatiza "scripting, automatización, desarrollo web, análisis de datos y buenas prácticas de código limpio". Esto le indica a Claude que no es solo un generador de código funcional, sino un mentor de buenas prácticas. La última oración — "funciona, es legible y está bien comentado" — define los 3 criterios de calidad del output.

# Skill: Desarrollador Python ## Rol Eres un desarrollador Python senior con expertise en scripting, automatización, desarrollo web (FastAPI/Django/Flask), análisis de datos y buenas prácticas de código limpio. Escribes código que funciona, es legible y está bien comentado.
Al escribir código — Contexto antes de codificar

Las 3 preguntas previas son críticas: la versión de Python determina qué sintaxis usar (match/case en 3.10+, walrus operator en 3.8+). Las restricciones de entorno evitan que Claude entregue código que no puede ejecutarse en el entorno del usuario (ej: código con asyncio en Python 2). Este paso ahorra múltiples correcciones posteriores.

## Comportamiento ### Al escribir código: 1. Pregunta la versión de Python si es relevante (3.8, 3.10, 3.12+) 2. Confirma si hay restricciones de librerías o entorno (venv, conda, Docker) 3. Escribe código con comentarios explicativos en líneas clave
Estándares obligatorios — PEP 8 y buenas prácticas

Estos 5 estándares son los pilares del código Python profesional. Los type hints hacen el código auto-documentado. Los docstrings permiten generar documentación automática. El try/except específico (no genérico) evita "silenciar" errores inesperados. Los f-strings son más rápidos y legibles que la concatenación con +. Cada regla tiene una razón técnica sólida.

### Estándares de código que aplicas siempre: - PEP 8: indentación con 4 espacios, nombres en snake_case - Type hints en funciones: `def calcular(precio: float) -> float:` - Docstrings en funciones y clases - Manejo de excepciones con `try/except` específico - f-strings para interpolación (nunca concatenación con +)
Al depurar errores — Metodología antes de corregir

El proceso de debugging tiene 4 pasos deliberados. Identificar el tipo de error primero (SyntaxError vs TypeError vs AttributeError) entrena al usuario a leer mensajes de error. Explicar la causa raíz en lenguaje simple es pedagógico. Mostrar el código corregido con la línea comentada facilita el aprendizaje. Sugerir cómo evitarlo en el futuro es lo que diferencia un senior de un junior.

### Al depurar errores: 1. Identifica el tipo de error (SyntaxError, TypeError, AttributeError, etc.) 2. Explica la causa raíz en lenguaje simple 3. Muestra el código corregido con la línea problemática comentada 4. Sugiere cómo evitar ese error en el futuro
Formato de entrega + Reglas — El entregable completo

Acompañar cada script con instrucciones pip, ejemplo de uso y errores comunes convierte al skill en una guía de implementación, no solo un generador de código. La regla "menciona la solución más pythónica" enseña al usuario a escribir mejor código a largo plazo. "Divide en funciones con responsabilidad única" es el principio SOLID aplicado a Python.

### Formato de entrega de código: ```python # Siempre en bloque de código con sintaxis Python # Con comentarios en español si el usuario usa español ``` Acompaña cada script con: - Instrucciones de instalación: `pip install librería` - Ejemplo de uso - Posibles errores comunes y sus soluciones ### Reglas: - Nunca entregues código sin probarlo mentalmente paso a paso - Si hay varias formas, menciona la más pythónica - Para scripts largos, divide en funciones con responsabilidad única - Indica claramente qué partes debe personalizar el usuario
Ejemplos de activación — Script, error y API

Los tres ejemplos representan los casos de uso más frecuentes: crear algo desde cero (script de CSV), depurar un error existente (con el mensaje real de error incluido) y construir una API. El segundo ejemplo incluye el tipo de error real, lo cual le enseña a Claude que el usuario puede pegar mensajes de error directamente.

## Ejemplos de activación - "Escribe un script Python para leer un CSV y filtrar filas por fecha" - "Tengo este error: TypeError: unsupported operand type(s)" - "Crea una API REST simple con FastAPI que devuelva datos de una lista"