Pular pro conteúdo

Uv skill

O Claude para de usar pip e ambiente virtual na mão e roda seus scripts e projetos Python com o uv, do jeito que a Astral recomenda.

por astral-sh

instalações
4.900
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

É o guia da Astral, a empresa que faz o uv, pro agente trabalhar com Python. O uv é um gerenciador de pacotes e projetos que substitui pip, pipx, pyenv, virtualenv e poetry. Com a skill, o Claude roda script com uv run em vez de chamar o python direto.

Ela separa os casos: script avulso, com as dependências declaradas no próprio arquivo; projeto com pyproject.toml ou uv.lock, onde adiciona e remove pacotes com uv add e uv remove e instala tudo com uv sync; ferramenta de linha de comando rodada sem instalar, com uvx; e o modo pip só pra projeto antigo com requirements.txt.

Também traz a tradução dos comandos de pyenv, pipx e pip pro uv e avisa onde não usar: projeto com Poetry ou PDM fica com a ferramenta dele. Rodar pacote desconhecido com uvx é tratado como risco.

Nas palavras de quem fez

Guide for using uv, the Python package and project manager. Use this when working with Python projects, scripts, packages, or tools.

astral-sh, no SKILL.md

Quando usar

  • Rodar um script Python que alguém te mandou sem instalar nada na mão
  • Começar um projeto Python novo já organizado
  • Adicionar uma biblioteca, como requests ou pandas, a um projeto
  • Rodar um script com uma versão específica do Python
  • Migrar um projeto que usava pip e requirements.txt

Depois de instalar, é só pedir assim

  • Roda esse script da planilha aqui, ele precisa do pandas
  • Cria um projeto Python novo chamado relatorios e adiciona o requests
  • Roda esse script com o Python 3.12

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 Uv 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 Uv, 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 precisa pra funcionar?

O uv instalado no computador. A skill não traz o programa, ela ensina o Claude a usar. Não pede chave de API nem conta paga.

Roda no Codex e no Antigravity?

Roda em qualquer agente que execute comandos no terminal. A skill é só texto com as regras e os comandos do uv.

Ela mexe em projeto com Poetry?

Não. Se a pasta tem poetry.lock ou pdm.lock, a orientação é deixar o projeto com a ferramenta que ele já usa. Ela também não cria requirements.txt novo nem instala ferramenta no sistema sem você pedir.

Levar essa skill

1x uvR$ 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