Agent Skills

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Skills ensinam o Agent novas capacidades. Elas permitem que você compartilhe sua experiência, padrões preferidos e conhecimento especializado com o Agent para que ele produza resultados melhores e mais consistentes.

​

Por que Skills são importantes

Toda vez que você constrói com o Agent, você cria contexto útil: soluções para problemas, decisões de design, preferências de framework. Mas esse contexto desaparece quando o chat termina. Skills preservam isso. Uma Skill de animação GSAP ensina o Agent como usar uma biblioteca específica corretamente. Uma Skill de sistema de design garante que ele aplique suas cores exatas e regras de espaçamento. Uma Skill de correção de bugs captura uma solução para que o Agent não repita o mesmo erro. Tarefas que antes eram inconsistentes se tornam confiáveis. Skills também são um padrão aberto. Elas funcionam com qualquer agente, incluindo o Replit Agent, para que você possa carregá-las entre ferramentas.

​

Skills proativas vs. reativas

Um framework para pensar sobre quando e como criar Skills. Entender ambos os padrões torna você mais eficaz.

​

Skills proativas

Skills proativas são aquelas que você adiciona antes de começar a construir. Pesquise as bibliotecas ou padrões que você quer usar, encontre ou crie Skills para eles e, em seguida, comece a fazer prompts. Exemplo: Antes de construir um site de portfólio com animações SVG desenhadas à mão, pesquise bibliotecas de animação e encontre o GSAP. Instale uma Skill GSAP React e, em seguida, faça um prompt ao Agent para construir as animações. O Agent tem o conhecimento especializado que precisa desde o início — ele entende a API da biblioteca, melhores práticas e padrões comuns. Sem a Skill, ele pode produzir algo genérico ou incorreto. Esse padrão funciona bem quando:

• Você está usando uma biblioteca popular mas com padrões nuançados que o Agent pode não acertar sozinho
• Você quer escolhas de design consistentes em todo o projeto (tipografia, espaçamento, estilo de animação)
• Você está iniciando um projeto e já sabe a direção técnica

​

Skills reativas

Skills reativas são aquelas que você cria após resolver um problema. Você encontra um problema, o depura com o Agent, corrige e, em seguida, captura a solução para que não aconteça novamente. Exemplo: Enquanto constrói um Canvas para um app mobile, você nota bordas irregulares em imagens que pioram ao fazer zoom. Depurar com o Agent revela que isso é aliasing de minificação — um problema de renderização onde as imagens ficam piores à medida que encolhem, de forma contraintuitiva. Após implementar uma correção, peça ao Agent para criar uma Skill: O Agent usa o histórico da conversa para escrever uma Skill específica do projeto. Da próxima vez que o problema surgir, você pode apontar o Agent para a Skill em vez de depurar do zero. Esse padrão funciona bem quando:

• Você corrigiu um bug não óbvio e quer evitar que ele ocorra novamente
• Você aprendeu algo sobre a arquitetura do seu app durante uma sessão de depuração
• Você quer codificar uma solução que levou um esforço significativo para descobrir

​

Sendo seletivo com Skills

Pense nas Skills como instruções que você daria a um amigo para encontrar seu apartamento. Uma lista direcionada de instruções funciona. Um fichário cheio de documentação não funciona — ninguém tem tempo para ler isso, e os detalhes importantes se perdem. O mesmo se aplica ao Agent. Se você adicionar muitas Skills, o Agent pode ficar confuso. Seja deliberado sobre quais Skills você ativa para um determinado projeto e remova as que você não precisa mais.

​

Considerações de segurança

Skills do painel de Skills do Replit são auditadas para segurança. Mas Skills podem ser instaladas de qualquer lugar — elas vêm de um repositório de código aberto onde qualquer pessoa pode contribuir. Como Skills são instruções que o Agent segue, uma Skill maliciosa poderia dizer ao Agent para exfiltrar dados sensíveis do seu projeto. Antes de instalar qualquer Skill de uma fonte externa:

1. Abra o arquivo. Skills são apenas Markdown. Leia o conteúdo em /.agents/skills/ antes de usá-las.
2. Verifique a fonte. Confirme que a Skill vem de um repositório ou autor confiável.
3. Revise o que instrui. Certifique-se de que a Skill não faz referência a URLs externas suspeitas ou solicita informações sensíveis.

​

Skills vs. servidores MCP

Skills e servidores MCP são as duas principais formas de estender agentes, e servem a propósitos diferentes. Skills são eficientes em contexto. Apenas uma breve descrição é carregada até que a Skill seja invocada. Use Skills para:

• Fluxos de trabalho e convenções (“como implantar”, “checklist de revisão de código”)
• Materiais de referência (padrões de API, guias de estilo, sistemas de design)
• Prompts reutilizáveis e conhecimento especializado (bibliotecas de animação, padrões de framework)

Servidores MCP são pesados em contexto. Todas as descrições de ferramentas são carregadas antecipadamente, o que pode degradar a qualidade da saída se você adicionar muitos. Use servidores MCP para:

• Conectar a serviços externos (Notion, Linear, Figma)
• Ações que precisam de acesso à API
• Ferramentas que fazem coisas, não apenas instruem

A distinção principal: Skills definem como seu agente deve funcionar. Servidores MCP definem o que seu agente pode acessar. Ambos funcionam para agentes de codificação como o Replit Agent e para agentes que você constrói por conta própria.

​

Próximos passos