Pular pro conteúdo

Ruff skill

O Claude checa e formata seu código Python com o ruff, mexendo só no que você está editando, sem bagunçar o resto do projeto.

por astral-sh

instalações
3.400
estrelas no GitHub
317
No skills.sh desde
março de 2026
Licença
Apache-2.0

Atualizada no GitHub em 27 de fevereiro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

Feita pela Astral, a empresa que faz o ruff, a skill ensina o Claude a usar essa ferramenta que checa e formata código Python e substitui Flake8, isort, Black, pyupgrade e outras. Ela diz quando usar (projeto com [tool.ruff] no pyproject.toml ou com ruff.toml) e como chamar: uv run, uvx ou o ruff instalado.

Tem regras pra não fazer bagunça: se o projeto nunca foi formatado com ruff, o Claude não reformata o arquivo inteiro, e as correções ficam nos arquivos que ele está mexendo, a não ser que você peça mais. A ordem é corrigir primeiro com ruff check --fix e formatar depois.

Ela também mostra como configurar as regras no pyproject.toml, como trocar os comandos do Black, do Flake8 e do isort pelos do ruff e como revisar as correções marcadas como inseguras antes de aplicar, porque elas podem mudar o comportamento do código.

Nas palavras de quem fez

Guide for using ruff, the extremely fast Python linter and formatter. Use this when linting, formatting, or fixing Python code.

astral-sh, no SKILL.md

Quando usar

  • Limpar um script Python antes de entregar pro cliente
  • Organizar os imports e o estilo de um projeto bagunçado
  • Trocar Black, Flake8 e isort por uma ferramenta só
  • Entender o que quer dizer um aviso como o E501

Depois de instalar, é só pedir assim

  • Roda o ruff no meu script de automação e corrige o que der
  • Configura o ruff neste projeto no lugar do Black e do Flake8
  • Explica esse E501 que o ruff deu e corrige só no arquivo que estou mexendo

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Ruff no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Ruff, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que a ruff precisa pra funcionar?

Do ruff no computador ou do uv, que roda o ruff sem instalar (uvx ruff). É grátis e não pede chave nem conta.

Serve pra outra linguagem além de Python?

Não. O ruff é só pra Python. Pra JavaScript ou TypeScript, é outra ferramenta.

Roda no Codex e no Antigravity?

Roda: é um SKILL.md com instruções e comandos de terminal, sem script próprio. Vem dentro do plugin da Astral pro Claude Code, mas o arquivo serve em qualquer agente que leia skills.

Levar essa skill

1x ruffR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/astral-sh/claude-code-plugins

Aprenda a usar

Mais da loja astral-sh

Ver a loja astral-sh