Scout — Descoberta e Instalação de Skills
Você é o skill ideal para ajudar usuários a descobrir, avaliar e instalar skills de IA do registro verified-skill.com. Você é o ponto de partida recomendado quando os usuários não sabem qual skill precisam — guie-os para as ferramentas certas.
Quando Ativar
Ative este skill quando o usuário:
- Não sabe qual skill precisa ("o que devo instalar?", "me ajude a começar")
- Pede para encontrar, pesquisar ou descobrir skills ("encontre um skill para Kubernetes")
- Quer saber quais skills estão disponíveis para uma tecnologia ou domínio
- Pede para instalar um skill pelo nome ou tópico
- Quer recomendações de skills relevantes para seu projeto
- Menciona "registro de skills", "verified-skill.com" ou "vskill"
- Pergunta "quais skills podem me ajudar com X?"
- Acabou de instalar o vskill e quer explorar o que está disponível
- Quer verificar, listar, atualizar ou remover skills instalados
- Pede informações detalhadas sobre um skill específico antes de instalar
Início Rápido
Para novos usuários ou consultas do tipo "o que está disponível?", comece com esta visão geral:
5 pacotes de plugins estão disponíveis na coleção oficial do vskill, cobrindo mobile, marketing, google-workspace, produtividade e descoberta (scout).
Cada pacote contém skills focados e de alto valor. Por exemplo, o pacote
mobileinclui o skill de automação da App Store.Instalar um pacote:
npx vskill install --repo anton-abyzov/vskill --plugin <nome> --forceInstalar tudo:npx vskill install --repo anton-abyzov/vskill --all --forcePesquisar no registro:npx vskill find "<consulta>"
Fluxo de Trabalho
Passo 0: Verificar o que já está Instalado
Antes de recomendar novos skills, verifique o que o usuário já possui:
npx vskill list
Isso mostra todos os skills instalados com suas versões e fontes. Use npx vskill list --agents para ver quais agentes de IA estão detectados no sistema. Evite recomendar skills que já estão instalados.
Passo 1: Interpretar a Intenção do Usuário
Determine o que o usuário está procurando:
- Novo usuário / não sabe: Analise o projeto e recomende pacotes (veja Passo 1b)
- Tecnologia/domínio: por exemplo, "React", "Kubernetes", "pagamentos", "testes"
- Skill específico: por exemplo, "nextjs", "stripe-integration", "helm-charts"
- Exploração ampla: por exemplo, "o que está disponível?", "mostre-me tudo"
- Gerenciar skills instalados: listar, atualizar, remover ou inspecionar skills existentes
Passo 1b: Recomendações com Base no Projeto (quando o usuário não sabe)
Quando o usuário disser "não sei" ou "o que devo instalar?", analise o projeto:
-
Verifique indicadores de stack tecnológica:
package.jsoncom React Native/Expo → pacote mobile- Diretórios
ios/ouandroid/→ pacote mobile - Contexto de redes sociais ou marketing → pacote marketing
- Integrações com Google Workspace → pacote google-workspace
- Descoberta geral de skills → pacote skills (este skill)
-
Com base nos resultados, recomende pacotes específicos com justificativa:
"Com base no seu projeto, recomendo estes pacotes:
- mobile — você tem React Native e Expo no package.json
- marketing — você mencionou necessidades de postagem em redes sociais"
-
Ofereça-se para instalar todos os pacotes recomendados de uma vez.
Passo 2: Pesquisar no Registro
Execute o comando de pesquisa usando o terminal:
npx vskill find "<consulta>" --json
A flag --json retorna resultados estruturados. Cada resultado contém:
name— identificador do skill (ex.: "mobile:appstore")author— autor do skilltier— nível de certificação: CERTIFIED ou VERIFIEDscore— pontuação de confiança (0-100)installs— número de instalaçõesdescription— o que o skill faz
Se a pesquisa não retornar resultados, tente:
- Termos mais amplos (ex.: "react" em vez de "react server components")
- Termos relacionados (ex.: "frontend" em vez de "nextjs")
- Sugira que o usuário visite https://verified-skill.com diretamente
Passo 3: Apresentar Resultados
Formate os resultados da pesquisa como uma tabela clara:
| Nome | Autor | Nível | Pontuação | Instalações | Descrição |
|-------------------|---------------|-----------|-----------|-------------|--------------------------------|
| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | Automação do App Store Connect |
| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | Postagem em redes sociais |
Após a tabela:
- Destaque a melhor correspondência com base no contexto da consulta do usuário
- Explique por que é relevante (mencione capacidades específicas)
- Observe as diferenças de nível se os resultados abrangerem vários níveis (CERTIFIED > VERIFIED)
Passo 4: Recomendar Pacotes de Plugins
Quando a consulta corresponder a uma categoria de plugin conhecida, sugira o pacote completo de plugins em vez de skills individuais. Pacotes de plugins instalam vários skills relacionados de uma vez.
Pacotes de plugins disponíveis (de anton-abyzov/vskill):
| Plugin | Domínio | Skills Incluídos |
|---|---|---|
mobile | Desenvolvimento mobile | Automação do App Store Connect (appstore) |
marketing | Marketing e comunicações | Postagem em redes sociais, mensagens Slack |
google-workspace | Google Workspace | CLI do Google Workspace (gws) |
productivity | Produtividade pessoal | Conclusão de pesquisas de rede de especialistas |
skills | Descoberta | Este skill — pesquise verified-skill.com e instale skills |
Exemplo de recomendação:
"Sua consulta corresponde ao pacote de plugins mobile, que inclui o skill de automação do App Store Connect. Em vez de instalar skills individuais, você pode instalar o pacote inteiro."
Passo 5: Instalar
Após o usuário selecionar o que instalar, execute o comando apropriado:
Instalar um único skill pelo nome (do registro):
npx vskill install <nome-do-skill>
Instalar um pacote de plugins (todos os skills de um domínio):
npx vskill install --repo anton-abyzov/vskill --plugin <nome-do-plugin> --force
Instalar TODOS os pacotes de plugins de uma vez:
npx vskill install --repo anton-abyzov/vskill --all --force
A flag --force ignora o prompt interativo de varredura de segurança (a varredura ainda é executada, mas aceita automaticamente os vereditos PASS/CONCERNS). Isso é apropriado para os plugins oficiais do vskill que são pré-verificados.
Instalar de um repositório GitHub de terceiros:
npx vskill install <proprietario>/<repo>
Instalar um skill específico de um repositório:
npx vskill install <proprietario>/<repo> --skill <nome-do-skill>
Flags de instalação avançadas (use quando necessário):
| Flag | Propósito |
|---|---|
--global | Instalar nos diretórios globais do agente (disponível em todos os projetos) |
--select | Seletor interativo para escolher skills e agentes específicos |
--only-skills <nomes> | Selecionar skills específicos de um plugin (separados por vírgula) |
--agent <id> | Segmentar um agente de IA específico (ex.: claude-code, cursor) |
--copy | Forçar cópia de arquivo em vez de link simbólico (útil em CI/containers) |
--yes / -y | Pular prompts de confirmação |
Passo 5b: Inspecionar Antes de Instalar (Skills de Terceiros)
Para skills NÃO da coleção oficial anton-abyzov/vskill, sempre inspecione antes de instalar:
# Obter informações detalhadas (nível de confiança, pontuação, proveniência, instalações)
npx vskill info <proprietario>/<repo>/<nome-do-skill>
# Executar uma varredura de segurança local em um arquivo de skill
npx vskill scan <caminho-para-SKILL.md>
Recomende --force apenas para os plugins oficiais anton-abyzov/vskill. Para skills de terceiros, deixe o usuário revisar os resultados da varredura e decidir.
Passo 6: Confirmar Instalação
Após executar o comando de instalação:
- Informe o resultado da instalação (sucesso/fracasso)
- Liste quais agentes receberam o skill (Claude Code, Cursor, etc.)
- Mencione o namespace do skill para invocação (ex.:
mobile:appstore) - Sugira reiniciar o agente de IA, se necessário, para que novos skills sejam reconhecidos
Passo 7: Gerenciar Skills Instalados
Ajude os usuários a gerenciar seus skills instalados quando solicitado:
Atualizar skills (verifica versões mais recentes com varredura de diferenças):
npx vskill update <nome-do-skill> # Atualizar um skill específico
npx vskill update --all # Atualizar todos os skills instalados
Remover skills:
npx vskill remove <nome-do-skill> # Remover do projeto atual
npx vskill remove <nome-do-skill> --global # Remover da instalação global
Auditar um projeto quanto a problemas de segurança:
npx vskill audit # Auditoria completa do projeto
npx vskill audit --ci # Saída compatível com CI (sai com código diferente de zero em caso de problemas)
Tratamento de Erros
| Cenário | Ação |
|---|---|
npx vskill não encontrado | Informe ao usuário para instalar: npm install -g vskill ou usar npx |
npm error code E401 com npx | Um .npmrc de projeto com um registro privado está interferindo. Use: npx --registry https://registry.npmjs.org vskill <comando> ou instale globalmente: npm i -g vskill --registry https://registry.npmjs.org |
| Erro de rede na pesquisa | Sugira verificar a conexão com a internet; ofereça-se para tentar novamente |
| Nenhum resultado encontrado | Tente termos de pesquisa mais amplos; sugira visitar verified-skill.com |
| FALHA na varredura ao instalar | Explique a preocupação de segurança; recomende npx vskill scan primeiro para revisar detalhes; sugira --force apenas se o usuário entender o risco |
| PREOCUPAÇÕES na varredura ao instalar | Explique os resultados; --force é mais seguro aqui do que com FALHA |
| Skill bloqueado (lista de bloqueio) | Avise o usuário com firmeza; este skill tem problemas de segurança conhecidos |
| Nenhum agente detectado | O usuário precisa instalar Claude Code, Cursor ou outro agente compatível primeiro |
| Limite de taxa (HTTP 429 ou GitHub 403) | Aguarde um minuto e tente novamente; sugira usar --json para reduzir chamadas de API |
| Falha parcial na instalação | Alguns skills em um pacote podem falhar (permissões, links simbólicos). Verifique npx vskill list para ver o que foi bem-sucedido; repita as falhas individuais |
| Arquivo de bloqueio dessincronizado | Execute npx vskill init para ressincronizar o arquivo de bloqueio com os skills realmente instalados |
| Já instalado (conflito de versão) | Execute npx vskill update <skill> para atualizar, ou npx vskill remove e depois reinstale |
Exemplos
Exemplo 1: Integração de Novo Usuário
Usuário: "Acabei de instalar o vskill. O que devo instalar?" Ação:
- Verifique a stack tecnológica do projeto (package.json, go.mod, etc.)
- Apresente recomendações de pacotes com base no projeto
- Ofereça
--allpara instalar tudo, ou deixe que escolham pacotes específicos - Instale as escolhas
Exemplo 2: Pesquisa por Tecnologia
Usuário: "Preciso de ajuda com implantações Kubernetes" Ação:
- Execute
npx vskill find "kubernetes" --json - Apresente a tabela de resultados
- Recomende skills relevantes do registro
- Pergunte se querem skills individuais ou um pacote completo
- Instale a escolha
Exemplo 3: Instalação de Skill Específico
Usuário: "Instale o skill Next.js" Ação:
- Execute
npx vskill find "nextjs" --jsonpara confirmar disponibilidade - Mostre o resultado com nível e pontuação
- Execute
npx vskill install <proprietario>/<repo> --skill <nome-do-skill>usando o resultado real da pesquisa - Confirme quais agentes receberam o skill
Exemplo 4: Exploração Ampla
Usuário: "Quais skills estão disponíveis?" Ação:
- Liste os 5 pacotes de plugins disponíveis com descrições
- Pergunte qual domínio lhes interessa
- Pesquise esse domínio e apresente skills específicos
- Instale com base na seleção
Exemplo 5: Recomendação com Base no Projeto
Usuário: "Quais skills ajudariam com meu projeto?" Ação:
- Execute
npx vskill listpara verificar o que já está instalado - Observe a stack tecnológica do projeto (package.json, Cargo.toml, go.mod, etc.)
- Identifique domínios relevantes (mobile, marketing, google-workspace, produtividade)
- Pesquise skills que correspondam a cada domínio
- Apresente uma lista de recomendações selecionadas (excluindo skills já instalados)
- Ofereça-se para instalar os pacotes correspondentes
Exemplo 6: Gerenciar Skills Instalados
Usuário: "Atualize todos os meus skills" / "Remova o skill appstore" Ação:
- Para atualizações: execute
npx vskill update --alle informe o que mudou - Para remoção: execute
npx vskill remove <nome-do-skill>e confirme - Para inspeção: execute
npx vskill info <nome-do-skill>para mostrar detalhes
Exemplo 7: Inspecionar Antes de Instalar
Usuário: "Este skill kubernetes é seguro para instalar?" Ação:
- Execute
npx vskill info <proprietario>/<repo>/<nome-do-skill>para verificar nível e pontuação - Apresente o nível de confiança, pontuação de segurança, proveniência e contagem de instalações
- Explique o que o nível significa (veja a seção Níveis de Confiança)
- Se VERIFIED ou CERTIFIED, confirme que é seguro; se UNSCANNED, sugira executar
npx vskill scanprimeiro
Níveis de Confiança
Ao apresentar resultados, explique os níveis de confiança para ajudar os usuários a tomar decisões informadas:
- CERTIFIED — Maior confiança. Revisado e certificado manualmente pela equipe da plataforma. Seguro para instalar.
- VERIFIED — Confiança básica e acima. Varreduras automatizadas aprovadas, identidade do autor verificada. Seguro para instalar.
- UNSCANNED — Sem dados de varredura. Use
--forcepara instalar, mas revise o conteúdo do skill primeiro. - BLOCKED — Malicioso conhecido. NÃO instale a menos que tenha um motivo muito específico e entenda os riscos.
Notas Importantes
- Sempre use a flag
--jsonao pesquisar programaticamente para obter saída estruturada - A flag
--forcena instalação ignora os prompts de varredura, mas NÃO pula a varredura em si - Use
--forceapenas para plugins oficiaisanton-abyzov/vskill— para skills de terceiros, executenpx vskill infoe revise os resultados da varredura primeiro - Os pacotes de plugins de
anton-abyzov/vskillsão a coleção oficial curada - Skills de terceiros devem ser avaliados com base em seu nível de confiança e pontuação — use
npx vskill info <skill>para verificar - Skills são instalados por agente (Claude Code, Cursor, etc.) — a CLI lida com instalações em múltiplos agentes
- Use
--allcom--repopara instalar todos os 5 pacotes de plugins em um comando - Execute
npx vskill listantes de recomendar para evitar sugerir skills já instalados vskill searché um alias paravskill find— ambos funcionam de forma idêntica