Encontrar Habilidades

Esta habilidade ajuda você a descobrir e instalar habilidades do ecossistema aberto de habilidades de agentes.

Quando Usar Esta Habilidade

Use esta habilidade quando o usuário:

• Pergunta "como faço X" onde X pode ser uma tarefa comum com uma habilidade existente
• Diz "encontre uma habilidade para X" ou "existe uma habilidade para X"
• Pergunta "você pode fazer X" onde X é uma capacidade especializada
• Expressa interesse em estender as capacidades do agente
• Quer procurar ferramentas, modelos ou fluxos de trabalho
• Menciona que gostaria de ter ajuda com um domínio específico (design, testes, implantação, etc.)

As ferramentas de habilidade

O Cherry oferece duas ferramentas integradas para habilidades — use-as e NÃO acesse npx skills, git, ou qualquer gerenciador de pacotes:

• search_skills(query) — pesquisa no marketplace por palavra-chave. Retorna correspondências, cada uma com um valor opaco install_source.
• install_skill(install_source) — instala UMA habilidade na biblioteca gerenciada do Cherry e a habilita para este agente. O Cherry clona o repositório, instala apenas essa habilidade e a registra em uma única etapa determinística. O tratamento de permissões segue o modo de permissão Claude ativo (Etapa 6).

Navegue pelas habilidades em: https://skills.sh/

Como Ajudar Usuários a Encontrar Habilidades

Etapa 1: Entenda o que Eles Precisam

Quando um usuário pede ajuda com algo, identifique:

1. O domínio (por exemplo, React, testes, design, implantação)
2. A tarefa específica (por exemplo, escrever testes, criar animações, revisar PRs)
3. Se esta é uma tarefa comum o suficiente para que uma habilidade provavelmente exista

Etapa 2: Verifique a Tabela de Classificação Primeiro

Antes de executar uma pesquisa na CLI, verifique a tabela de classificação skills.sh para ver se uma habilidade bem conhecida já existe para o domínio. A tabela de classificação classifica as habilidades pelo total de instalações, apresentando as opções mais populares e testadas em batalha.

Por exemplo, as principais habilidades para desenvolvimento web incluem:

• vercel-labs/agent-skills — React, Next.js, design web (mais de 100 mil instalações cada)
• anthropics/skills — Design frontend, processamento de documentos (mais de 100 mil instalações)

Etapa 3: Pesquise Habilidades

Se a tabela de classificação não cobrir a necessidade do usuário, chame a ferramenta search_skills:

• Usuário pergunta "como faço meu aplicativo React ficar mais rápido?" → search_skills("react performance")
• Usuário pergunta "você pode me ajudar com revisões de PR?" → search_skills("pr review")
• Usuário pergunta "preciso criar um changelog" → search_skills("changelog")

Cada resultado inclui um install_source opaco, registro de origem, URL de revisão, contagem de instalações e contagem de estrelas disponível. Passe o valor exato de install_source para install_skill.

Etapa 4: Verifique a Qualidade Antes de Recomendar

Não recomende uma habilidade com base apenas nos resultados da pesquisa. Sempre verifique:

1. Contagem de instalações — Prefira habilidades com mais de 1 mil instalações. Tenha cuidado com qualquer coisa abaixo de 100.
2. Reputação da origem — Fontes oficiais (vercel-labs, anthropics, microsoft) são mais confiáveis do que autores desconhecidos.
3. Estrelas no GitHub — Verifique o repositório de origem. Uma habilidade de um repositório com menos de 100 estrelas deve ser tratada com ceticismo.

Etapa 5: Apresente Opções ao Usuário

Quando encontrar habilidades relevantes, apresente-as ao usuário com:

1. O nome da habilidade e o que ela faz
2. A contagem de instalações e a origem
3. Que você pode instalá-la para eles no Cherry
4. Um link para saber mais em skills.sh

Exemplo de resposta:

I found a skill that might help! The "react-best-practices" skill provides
React and Next.js performance optimization guidelines from Vercel Engineering.
(185K installs)

I can install it into Cherry's skill library for you — want me to go ahead?

Learn more: https://skills.sh/vercel-labs/agent-skills/react-best-practices

Etapa 6: Instalar (Usa o Modo de Permissão Ativo)

⚠️ Segurança: Habilidades são código de terceiros que é executado com permissões completas do agente. Uma habilidade maliciosa pode ler, modificar ou excluir arquivos em seu sistema.

Antes de instalar qualquer habilidade:

1. Mostre um aviso de segurança — diga ao usuário que a habilidade é código de terceiros e será executada com permissões completas do agente.
2. Forneça um link de revisão — a página skills.sh (ou o repositório de origem) para que o usuário possa revisar o SKILL.md da habilidade e quaisquer scripts que ela contenha.
3. Exija intenção de instalação — chame install_skill apenas quando o usuário pediu para instalar a habilidade ou aceitou uma opção apresentada. Uma solicitação apenas de pesquisa não deve modificar a biblioteca de habilidades.

Uma vez que o usuário tenha expressado intenção de instalação, chame install_skill com o install_source exato

…