Warp Common Skills: fluxos de agente reutilizados entre repositórios

Para quem

Use este repositório quando tiver um conjunto reutilizável de fluxos de agente, convenções ou procedimentos que sirvam em mais do que um repositório e precisem de um sítio partilhado em vez de ficarem presos a um único repo. Guarda agent skills «comuns entre repositórios», não scripts privados de um projeto.

Pré-requisito: o agente atual segue as notas e é Warp. O comando de instalação recomendado leva --agent warp --global; não o reescreva para outro agente não nomeado. Uma skill tem de servir mesmo a mais do que um repositório; se só um o precisar, não a force para esta biblioteca partilhada.

Do lado da autoria: cada skill possui um diretório sob .agents/skills/, o ficheiro obrigatório é SKILL.md com YAML frontmatter, pelo menos um name em kebab-case e uma description que diga o que faz e quando usá-la. Não invente outros campos obrigatórios.

Conclua a primeira tentativa em 3 minutos

Página oficial:

https://github.com/warpdotdev/common-skills

Instalação recomendada (--global muda as skills globais desta máquina; confirme o repositório e --agent warp antes de executar):

npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global

As notas não dizem para que diretório o npx escreve no disco. Depois de instalar, volte ao Warp e veja se estas common skills se podem selecionar. Não trate .agents/skills/ do repositório como o caminho de instalação na sua máquina.

Na primeira vez, não altere o conteúdo das skills partilhadas nem faça fork. Escolha uma tarefa só de leitura de baixo risco e deixe o Warp decidir, pela description de uma skill instalada, se a deve usar.

Sinal de sucesso: o Warp mostra as skills acabadas de instalar e o assistente decide se invoca por description. Se o comando falhar, pare; não retire --agent warp nem mude para um instalador que nunca apareceu.

Casos de uso

Caso 1: Instalar todas as common skills no Warp em global. Execute o add ... --skill '*' --agent warp --global acima. --skill '*' significa o conjunto de skills desta biblioteca partilhada. Depois de instalar, só verifique que o Warp as consegue selecionar; não instale ao mesmo tempo uma segunda cópia não nomeada.

Caso 2: Mais tarde, atualizar skills Warp já instaladas. O comando das notas:

npx skills@latest update --global --agent warp

Isto também escreve em global. Confirme o ambiente Warp atual, execute e veja se as skills ainda se podem selecionar. Se uma skill partilhada precisar de uma exceção de repositório, as notas pedem para acrescentar uma small local companion skill em vez de fazer fork da skill partilhada, salvo se a alteração servir todos os repositórios. Não faça fork na primeira atualização.

Limites de uso

O caminho principal só está evidenciado para o Warp: add e update levam --agent warp --global. Não os aplique a outros agentes.

A disposição no repositório só está evidenciada como .agents/skills/ e name / description em SKILL.md. Não escreva esse diretório como localização de instalação local do npx.

Prefira copiar só as skills de que o repositório realmente precisa; as exceções usam um local companion, não faça fork de ânimo leve.

As notas não dão cobertura linguística, preços nem comandos de instalação para outros agentes. O não documentado permanece desconhecido.