Hook Format Python Files — black auto sobre Python post-edit (1,036 installs)

Hook con 1,036 installs (top en post-tool). Corre black formatter automáticamente sobre archivos Python después de cada Edit. PEP-8 garantizado sin que tengas que pensar.

Qué es#

Después de cada Edit a un archivo Python (.py), el hook corre black automáticamente. Hook event: PostToolUse.

black es "the uncompromising Python code formatter": opinionado, no configurable. Tu código queda PEP-8 + estilo black sin discusión.

1,036 installs lo hacen el top en categoría post-tool — uno de los hooks más adoptados del catálogo.

Tabla resumen#

Campo	Valor
Categoría aitmpl	`post-tool`
Installs	1,036 (top de post-tool)
Hook event	`PostToolUse` (Edit)
Tool externo	`black`

Cómo se instala#

bash

npx claude-code-templates@latest --hook post-tool/format-python-files

Pre-requisito: black instalado (pip install black o pipx install black).

Para Claude:

bash

Instalé el hook post-tool/format-python-files. Verificá que `black`
esté en PATH. Probá: pedile a Claude que edite un archivo Python
mal formateado — debería quedar PEP-8 después.

Qué podés hacer con esto#

PEP-8 automático#

No importa cómo Claude indenta o pone espacios. Después del edit, black reformatea según convención.

Diffs sin ruido#

Sin formatting noise en git diff. Solo ves cambios semánticos.

Combo con Lint On Save#

Lint corre después de format. Catch issues que format no cubre (unused imports, complexity, etc.).

Para proyectos compartidos#

Si tu team usa black como standard, este hook garantiza que Claude lo respete sin que tengas que recordar pedírselo.

Para sesiones autónomas#

/goal o /loop largos: el código queda en buen formato sin tu intervención.

Cuándo NO conviene#

⚠️ Antes de instalar

Sin black instalado: el hook falla.
Si tu team usa otro formatter (autopep8, yapf, ruff): este hook es black-only.
Para proyectos con line length diferente: black default es 88. Si necesitás otro, configurá en pyproject.toml.
Para archivos no-Python: este hook es .py-only. Para JS usá Format JavaScript Files.

Bajalo de la fuente#

Ficha en aitmpl.com: Format Python Files Hook — comando exacto.
Config JSON: format-python-files.json.
Black oficial: black.readthedocs.io.

Recursos relacionados#

Format JavaScript Files Hook — equivalente para JS/TS.
Lint On Save Hook — combina format + lint.
Dependency Checker Hook — el top del catálogo, complementa con supply chain.