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

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#

Cómo se instala#

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

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

Para Claude:

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#

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.