Skills · Claude Code · Agent Skills

Python es una herramienta, no un servicio nuevo — sin negociación.

Piso para Python en datos/ML, automatización y herramientas: uv con lock, ruff y mypy --strict bloqueando el merge, frontera validada en runtime y seguridad básica. Las APIs o servicios nuevos nacen en los lenguajes del rol.

v0.4.0Disciplina · Python como ferramentagithub.com/schematizeme/skill-python

Mantenido por Lucas Andrade

schematize-python · v0.4.0bash
$ schematize install python
GitHub →descargar skill (.zip)/python-help · github.com/schematizeme/schematize-cli

Pisos innegociables

Nunca se desactivan "para ir más rápido". La lista completa está en la skill.

Herramienta, no backend nuevo

Una API o servicio nuevo nace en el rol de lenguajes; la excepción de servir un modelo es un servicio delgado, sin reglas de negocio.

uv con uv.lock commiteado

uv sync --frozen en CI; sin lock, lo transitivo cambia solo y funciona en mi máquina se vuelve literal.

ruff y mypy --strict bloquean el merge

Un solo formateador, noqa siempre con código y motivo; tipado estricto en el código nuevo y la frontera validada en runtime con pydantic.

Ejecución insegura vetada

pickle sobre datos externos, eval/exec sobre entrada, yaml.load sin SafeLoader, subprocess con shell=True y assert como validación están prohibidos.

Red con timeout, seguridad con secrets

Toda llamada de red tiene timeout explícito, y el módulo secrets, no random, sirve para todo lo relacionado con seguridad.

El notebook no es un entregable

Va sin salida, sin datos reales y sin credenciales; cuando se vuelve producto, pasa a ser un módulo en src/ con prueba y tipos.

Comandos

Instalados en .claude/commands/. Ejecuta /python-help cuando quieras.

/python-ccContext compact: guarda el handoff (contexto + checklist) en el archive y ejecuta /compact.
/python-claudeCrea o fusiona el CLAUDE.md siempre activo de schematize-python en la raíz del repo, sin sobrescribir bloques de otras skills.
/python-handoffGenera el handoff de contexto en el archive sin compactar: fin de sesión o cambio de tarea.
/python-helpLista todos los comandos de la skill.
/python-loadCarga a la fuerza todo el cuerpo normativo de schematize-python y lo aplica en la sesión.
/python-reviewRevisa .py/.ipynb contra el piso: ejecuta el gate y ruff, y lee lo que la máquina no lee.

Para agentes de IA

Instala sin humano en el bucle. Metadatos en llms.txt.

  • Ejecuta: git clone https://github.com/schematizeme/skill-python.git && ./skill-python/install.sh
  • O descarga https://github.com/schematizeme/skill-python/releases/latest/download/skill-python.zip y descomprime en .claude/skills/.
  • Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
  • Confirma con /python-help.

¿No quieres instalar?

Lee las normas completas y cópialas directo a tu proyecto — o instala la skill para que el agente las aplique solo.