CommunityEscrita e Ediçãogithub.com

work0r-ai/agent-kit

Instalador universal de Skills WorkorAI e MCP para Codex, Claude Code, OpenCode e outros clientes de agente.

O que é agent-kit?

Este skill transforma o agente em uma interface completa para o mercado de talentos WorkorAI, atendendo tanto candidatos quanto empregadores. Ele interpreta a intenção do usuário para rotear automaticamente para o fluxo de candidato (busca e candidatura a vagas) ou empregador (contratação, busca de candidatos e gestão de vagas), utilizando o servidor MCP do WorkorAI. Suporta os principais agentes de linha de comando como Claude Code, Cursor, Codex e OpenCode, e gerencia o armazenamento seguro de chaves API por função. O skill segue receitas detalhadas para cada cenário (como apresentar o *Agent Pick* com barras de adequação ou justificar rankings com dados do candidato), lida com autenticação e casos de borda, e redireciona para as URLs de onboarding corretas quando necessário. É um kit completo para integrar fluxos de recrutamento e candidatura diretamente no ambiente de desenvolvimento do agente.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add work0r-ai/agent-kit

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

WorkorAI

Use este skill para fluxos de trabalho do mercado de talentos WorkorAI por meio do servidor MCP WorkorAI. A superfície MCP tem função dupla (candidato + empregador); este skill roteia por intenção e delega os detalhes pesados de esquema/receita para os arquivos em references/.

Mapeamento de Gatilhos

  • Trate solicitações genéricas de busca de emprego como intenções WorkorAI por padrão.
  • Trate solicitações de contratação de empregadores como intenções WorkorAI quando o usuário pedir para contratar, publicar vagas, encontrar candidatos, revisar correspondências de candidatos, ou configurar o acesso MCP WorkorAI.
  • Frases fortes de candidato incluem "найди мне работу", "найти работу", "ищу работу", "подбери вакансию", "хочу работу", "find me a job", "I need work", "help me find a job", e "show me jobs".
  • Frases fortes de empregador incluem "найди кандидатов", "хочу нанять", "hire developers", "find candidates", "post a job", "search talent", e "help me recruit".
  • Não espere o usuário dizer "WorkorAI", "MCP" ou "API key".
  • Pule este skill apenas quando o usuário pedir claramente conselhos genéricos de carreira, escrita de currículo, coaching de entrevista, conselhos genéricos de contratação, ou empregos/candidatos fora do WorkorAI.

Primeira Resposta — Decisão de Função

  1. Decida a função a partir da intenção do usuário. Se for genuinamente ambíguo, faça uma pergunta curta de esclarecimento ("Você está procurando emprego ou contratando?") — não execute fluxos de candidato e empregador em paralelo.
  2. Intenção de candidato: leia references/candidate-catalog.md, references/candidate-recipes.md e references/auth-flow.md. Execute o fluxo de candidato: descubra (candidate.search_jobs → candidate.get_job) depois aja (apply_to_job, aceitar/recusar convites, retirar, vagas salvas). Casos de borda: references/candidate-troubleshooting.md.
    • Primeira resposta visível: comece com a persona de agente de carreira + valor (espelhe a linguagem do usuário), depois a configuração única — use o primeiro contato canônico em references/auth-flow.md ("O Que Dizer Primeiro (Candidato)"). Esta é uma ferramenta de desenvolvedor: narre as etapas que você executa; nunca imprima o valor da chave.
  3. Intenção de empregador: leia references/employer-catalog.md, references/employer-recipes.md e as seções de empregador de references/auth-flow.md. Escolha a receita que corresponde à intenção do usuário (contratar-de-vaga-específica, contratação livre, revisão de funil, limpeza de convites-pendentes ou ciclo de vida da vaga).
    • Para ENCONTRAR / AVALIAR / COMPARAR candidatos para uma vaga (o fluxo central de contratação): employer.search_candidates_for_job(jobId, tier:'best') → cascateie para good/weak via tierCounts → EXPLIQUE cada um a partir de seu matchExplanation (comece com verifiedSkills = comprovado em entrevista, mais a rationale) → para a lista de selecionados, employer.get_candidate_evidence(jobId, userId) para os fatos da entrevista + Q&A → escreva sua própria revisão comparativa baseada em evidências, depois convide. Este é o valor da plataforma — você justifica a classificação com nossos dados transparentes, você não está entregando ao usuário uma pontuação de caixa-preta.
  4. Todas as ferramentas (candidato e empregador) são visíveis em um tools/list anônimo — a visibilidade é descoberta, não autorização. O sinal de que você não tem uma chave utilizável é uma chamada falha, não uma ferramenta ausente: uma chamada de empregador não autenticada retorna requires employer authentication. Quando isso acontecer (ou antes da primeira chamada, se nenhuma chave salva foi encontrada), envie o usuário para a URL de onboarding correspondente (Home do Candidato ou Dashboard do Empregador) e aceite a nova chave em linha, depois tente novamente com o argumento apiKey.
  5. Não use curl no shell ou sondagem JSON-RPC bruta a menos que o usuário peça explicitamente para depurar a conectividade MCP.

Comportamento de Chave Salva

  • Resolva scripts/credential-store.mjs em relação a este SKILL.md.
  • Antes de pedir uma chave ao usuário, execute uma busca com escopo de função:
    • node scripts/credential-store.mjs get --role=candidate
    • node scripts/credential-store.mjs get --role=employer
  • A função padrão (sem --role) é candidate para compatibilidade retroativa.
  • Se uma chave salva for retornada, não a imprima. Use-a apenas como o argumento apiKey para ferramentas na função correspondente.
  • Quando o usuário fornecer uma nova chave, valide-a com uma única chamada de ferramenta na função correspondente.
  • Após a primeira chamada bem-sucedida com uma chave fornecida pelo usuário, o próximo passo voltado ao usuário deve ser perguntar: "Salvar esta chave WorkorAI para futuras buscas nesta máquina?"
  • Salve com node scripts/credential-store.mjs save --best-effort --role=<role> e passe a chave via stdin, não pelo argumento do comando.
  • Use save --shared-file --role=<role> apenas quando o usuário explicitamente quiser a alternativa de arquivo compartilhado.
  • Nunca armazene a chave em um repositório, transcrição de chat, linha de comando visível ou configuração MCP, a menos que o usuário escolha explicitamente esse modo de armazenamento.
  • Redija chaves WorkorAI na saída visível ao usuário como wai_[REDACTED].

Caminho Rápido do Candidato

  • Cadeia de URL de onboarding: https://workorai.com/candidate/login → /candidate/profile → aguarde a avaliação da entrevista → /candidate/home?tab=mcp para copiar a chave MCP.
  • Superfície completa de 9 ferramentas (uma chave de candidato chama todas — função + acesso ATIVO, sem escopo por ferramenta):
    • Descubra: candidate.search_jobs → candidate.get_job.
    • Candidate-se: candidate.apply_to_job (idempotente; bloqueado em uma entrevista concluída e avaliada — GATE_LOCKED/GATE_EVALUATING/GATE_FAILED redirecionam para onboarding, não tente novamente cegamente).
    • Convites: candidate.accept_invitation (→ APPLIED) / candidate.decline_invitation (TERMINAL — bloqueia novo convite; confirme primeiro). Veja o que está pendente com candidate.get_applications.
    • Gerencie: candidate.withdraw_application (saída suave, pode ser reconvidado), candidate.set_saved_job (estado desejado, NÃO é alternância) / candidate.get_saved_jobs (apenas PUBLICADOS).
  • Sempre apresente dois links distintos por vaga recomendada: página da vaga (jobUrl/url) e candidatura (applicationUrl/applyUrl). Nunca mostre apenas candidatura.
  • Superficie matchScore e habilidades correspondentes/faltantes — trate habilidades faltantes como lacunas a discutir, não rejeições. (matchScore é null na navegação recente sem pontuação — uma q de texto livre ou um candidato ainda não entrevistado; seniorityFit/matchReasons são sempre UNKNOWN/[].)
  • Correspondência mais forte com pontuação → apresente um Agent Pick (barras de adequação vinculadas a campos reais de matchExplanation), não uma lista plana; navegação sem pontuação → lista simples, sem barras. Veja references/candidate-recipes.md Receita 6.
  • Trate jobId bruto como metadados internos/de depuração, a menos que o usuário peça por ele.
  • Mini-esquemas: references/candidate-catalog.md. Receitas: references/candidate-recipes.md. Casos de borda: references/candidate-troubleshooting.md.

Caminho Rápido do Empregador

  • URL de emissão de chave: https://workorai.com/employer/dashboard (cartão MCP do Empregador na página).
  • Receita de contratação: employer.search_candidates_for_job(jobId, tier:'best') (cascateie para good/weak via tierCounts; explique a partir de cada matchExplanation — verifiedSkills/rationale) → employer.get_candidate_evidence(jobId, userId) para a lista de selecionados (fatos da entrevista + Q&A → sua própria revisão comparativa) → employer.get_candidate(userId) (inspecione existingApplications) → employer.invite_candidate(jobId, candidateUserId). Acompanhe com employer.list_invitations(jobId) e depois employer.list_applicants(jobId).
  • Contratação livre: employer.search_candidates_by_query(query) → escolha ou crie uma vaga → convide.
  • Revisão de funil: employer.list_applicants(jobId) → employer.set_review_status(applicationId, 'SHORTLISTED') (desbloqueia contato) → employer.get_applicant_detail(applicationId) e opcional employer.get_applicant_transcript.
  • Regras de reconvite: WITHDRAWN pode ser reconvidado (o serviço ATUALIZA a linha); DECLINED, INVITED e APPLIED bloqueiam com INVITE_BLOCKED: INVITE_NOT_ALLOWED. Sempre chame employer.get_candidate primeiro quando o candidato tiver qualquer interação anterior.
  • Bloqueio de contato: campos de contato do candidato são retornados apenas quando reviewStatus ∈ {SHORTLISTED, HIRED}. Abaixo disso, os campos são nulos.
  • employer.create_job é síncrono e leva de 5 a 30 segundos (análise do Gemini). Em timeout do cliente, NÃO reenvie rawText — recupere via employer.list_jobs({ status: 'DRAFT' }) e escolha a linha mais nova.
  • Mini-esquema completo: references/employer-catalog.md. Receitas: references/employer-recipes.md. Casos de borda: references/employer-troubleshooting.md.

Referências

Leia sob demanda com base na intenção:

  • references/candidate-catalog.md — mini-esquemas de ferramentas de candidato (9)
  • references/candidate-recipes.md — receitas de ordem de chamada de candidato
  • references/candidate-troubleshooting.md — cenários de erro do lado do candidato
  • references/employer-catalog.md — mini-esquemas de ferramentas de empregador (19)
  • references/employer-recipes.md — receitas de ordem de chamada de empregador
  • references/employer-troubleshooting.md — cenários de erro do lado do empregador
  • references/auth-flow.md — onboarding de candidato e empregador mais o fluxo de chave salva
  • references/troubleshooting.md — problemas MCP gerais / entre funções

Habilidades Relacionadas