CommunityRédaction et éditiongithub.com

work0r-ai/agent-kit

Kit de compétences universel WorkorAI pour agents (Codex, Claude Code, OpenCode, etc.) avec installation MCP.

Qu'est-ce que agent-kit ?

Ce kit de compétences permet à un agent d'interagir avec la place de marché de talents WorkorAI via le serveur MCP WorkorAI. Il gère à la fois le rôle candidat (recherche et postulation d'emplois) et le rôle employeur (recrutement, gestion des offres et des candidatures). La compétence analyse l'intention de l'utilisateur pour choisir le rôle approprié, puis lit les fichiers de référence (`references/`) pour obtenir des schémas détaillés et des recettes d'appel. Elle prend également en charge la gestion sécurisée des clés API (stockage, validation, récupération) et offre un chemin rapide pour les candidats et les employeurs. Les plateformes supportées incluent Codex, Claude Code, OpenCode et d'autres clients d'agents compatibles MCP.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

WorkorAI

Utilisez cette compétence pour les workflows de la place de marché de talents WorkorAI via le serveur MCP WorkorAI. La surface MCP est à double rôle (candidat + employeur) ; cette compétence achemine par intention et délègue les détails du schéma/recette aux fichiers references/.

Mappage de déclenchement

  • Traitez les demandes génériques de recherche d'emploi des candidats comme des intentions WorkorAI par défaut.
  • Traitez les demandes de recrutement des employeurs comme des intentions WorkorAI lorsque l'utilisateur demande à embaucher, publier des offres, trouver des candidats, examiner les correspondances de candidats ou configurer l'accès MCP WorkorAI.
  • Les phrases fortes pour les candidats incluent « найди мне работу », « найти работу », « ищу работу », « подбери вакансию », « хочу работу », « find me a job », « I need work », « help me find a job » et « show me jobs ».
  • Les phrases fortes pour les employeurs incluent « найди кандидатов », « хочу нанять », « hire developers », « find candidates », « post a job », « search talent » et « help me recruit ».
  • N'attendez pas que l'utilisateur dise « WorkorAI », « MCP » ou « API key ».
  • Ignorez cette compétence uniquement lorsque l'utilisateur demande clairement des conseils de carrière génériques, de la rédaction de CV, du coaching d'entretien, des conseils de recrutement génériques ou des emplois/candidats en dehors de WorkorAI.

Première réponse — Décision du rôle

  1. Décidez du rôle à partir de l'intention de l'utilisateur. Si vraiment ambigu, posez une courte question de clarification (« Cherchez-vous un emploi ou recrutez-vous ? ») — n'exécutez pas les flux candidat et employeur en parallèle.
  2. Intention candidat : lisez references/candidate-catalog.md, references/candidate-recipes.md et references/auth-flow.md. Exécutez le flux candidat : découvrez (candidate.search_jobs → candidate.get_job) puis agissez (apply_to_job, accepter/refuser les invitations, retirer, emplois sauvegardés). Cas particuliers : references/candidate-troubleshooting.md.
    • Première réponse visible : commencez par le persona d'agent de carrière + la valeur (reflétez le langage de l'utilisateur), puis la configuration unique — utilisez le premier contact canonique dans references/auth-flow.md (« What To Say First (Candidate) »). C'est un outil de développeur : racontez les étapes que vous exécutez ; n'imprimez jamais la valeur de la clé.
  3. Intention employeur : lisez references/employer-catalog.md, references/employer-recipes.md et les sections employeur de references/auth-flow.md. Choisissez la recette qui correspond à l'intention de l'utilisateur (recruter depuis une offre spécifique, recrutement libre, examen du funnel, nettoyage des invitations en attente ou cycle de vie de l'offre).
    • Pour TROUVER / ÉVALUER / COMPARER des candidats pour un poste vacant (le flux de recrutement principal) : employer.search_candidates_for_job(jobId, tier:'best') → cascade vers good/weak via tierCounts → EXPLIQUEZ chacun à partir de son matchExplanation (commencez par verifiedSkills = prouvé en entretien, plus la rationale) → pour la shortlist, employer.get_candidate_evidence(jobId, userId) pour les faits d'entretien + Q&A → rédigez votre propre revue comparative basée sur les preuves, puis invitez. C'est la valeur de la plateforme — vous justifiez le classement sur nos données en boîte blanche, vous ne remettez pas à l'utilisateur un score en boîte noire.
  4. Tous les outils (candidat et employeur) sont visibles dans un tools/list anonyme — la visibilité est la découverte, pas l'autorisation. Le signal que vous n'avez pas de clé utilisable est un appel échoué, pas un outil manquant : un appel employeur non authentifié renvoie requires employer authentication. Lorsque cela se produit (ou avant le premier appel, si aucune clé sauvegardée n'a été trouvée), envoyez l'utilisateur vers l'URL d'intégration correspondante (Candidate Home ou Employer Dashboard) et acceptez la nouvelle clé en ligne, puis réessayez avec l'argument apiKey.
  5. N'utilisez pas curl en shell ou de sondage JSON-RPC brut, sauf si l'utilisateur demande explicitement à déboguer la connectivité MCP.

Comportement avec la clé sauvegardée

  • Résolvez scripts/credential-store.mjs par rapport à ce SKILL.md.
  • Avant de demander une clé à l'utilisateur, effectuez une recherche limitée au rôle :
    • node scripts/credential-store.mjs get --role=candidate
    • node scripts/credential-store.mjs get --role=employer
  • Le rôle par défaut (sans --role) est candidate pour la rétrocompatibilité.
  • Si une clé sauvegardée est retournée, ne l'imprimez pas. Utilisez-la uniquement comme argument apiKey pour les outils du rôle correspondant.
  • Lorsque l'utilisateur fournit une nouvelle clé, validez-la avec un seul appel d'outil dans le rôle correspondant.
  • Après le premier appel réussi avec une clé fournie par l'utilisateur, la prochaine étape face à l'utilisateur doit être de demander : « Sauvegarder cette clé WorkorAI pour les futures recherches sur cette machine ? »
  • Sauvegardez avec node scripts/credential-store.mjs save --best-effort --role=<role> et passez la clé via stdin, pas dans l'argument de la commande.
  • Utilisez save --shared-file --role=<role> uniquement lorsque l'utilisateur veut explicitement le fallback du fichier partagé.
  • Ne stockez jamais la clé dans un dépôt, un transcript de chat, une ligne de commande visible ou une configuration MCP, sauf si l'utilisateur choisit explicitement ce mode de stockage.
  • Masquez les clés WorkorAI dans les sorties visibles par l'utilisateur sous la forme wai_[REDACTED].

Chemin rapide candidat

  • Chaîne d'URL d'intégration : https://workorai.com/candidate/login → /candidate/profile → attendez l'évaluation de l'entretien → /candidate/home?tab=mcp pour copier la clé MCP.
  • Surface complète de 9 outils (une clé candidat appelle les 9 — rôle + accès ACTIF, pas de portée par outil) :
    • Découvrir : candidate.search_jobs → candidate.get_job.
    • Postuler : candidate.apply_to_job (idempotent ; verrouillé par un entretien complété et évalué — GATE_LOCKED/GATE_EVALUATING/GATE_FAILED redirigent vers l'intégration, ne pas réessayer en aveugle).
    • Invitations : candidate.accept_invitation (→ APPLIED) / candidate.decline_invitation (TERMINAL — bloque la ré-invitation ; confirmez d'abord). Voyez ce qui est en attente avec candidate.get_applications.
    • Gérer : candidate.withdraw_application (sortie douce, réinvitable), candidate.set_saved_job (état souhaité, PAS une bascule) / candidate.get_saved_jobs (PUBLIÉ uniquement).
  • Présentez toujours deux liens distincts par emploi recommandé : page de l'emploi (jobUrl/url) et postuler (applicationUrl/applyUrl). Ne montrez jamais seulement postuler.
  • Affichez matchScore et les compétences correspondantes/manquantes — traitez les compétences manquantes comme des lacunes à discuter, pas des rejets. (matchScore est null en parcours de récence sans score — une q en texte libre ou un candidat pas encore interrogé ; seniorityFit/matchReasons sont toujours UNKNOWN/[].)
  • Meilleure correspondance notée → présentez un Agent Pick (barres d'adéquation liées aux vrais champs matchExplanation), pas une liste plate ; parcours sans score → liste plate, pas de barres. Voir references/candidate-recipes.md Recette 6.
  • Traitez le jobId brut comme métadonnée interne/de débogage, sauf si l'utilisateur le demande.
  • Mini-schémas : references/candidate-catalog.md. Recettes : references/candidate-recipes.md. Cas particuliers : references/candidate-troubleshooting.md.

Chemin rapide employeur

  • URL d'émission de clé : https://workorai.com/employer/dashboard (carte MCP employeur sur la page).
  • Recette de recrutement : employer.search_candidates_for_job(jobId, tier:'best') (cascade vers good/weak via tierCounts ; expliquez à partir de chaque matchExplanation — verifiedSkills/rationale) → employer.get_candidate_evidence(jobId, userId) pour la shortlist (faits d'entretien + Q&A → votre propre revue comparative) → employer.get_candidate(userId) (inspectez existingApplications) → employer.invite_candidate(jobId, candidateUserId). Suivez avec employer.list_invitations(jobId) et plus tard employer.list_applicants(jobId).
  • Recrutement libre : employer.search_candidates_by_query(query) → choisissez ou créez un poste vacant → invitez.
  • Examen du funnel : employer.list_applicants(jobId) → employer.set_review_status(applicationId, 'SHORTLISTED') (débloque le contact) → employer.get_applicant_detail(applicationId) et optionnellement employer.get_applicant_transcript.
  • Règles de ré-invitation : WITHDRAWN peut être réinvité (le service MET À JOUR la ligne) ; DECLINED, INVITED et APPLIED bloquent tous avec INVITE_BLOCKED: INVITE_NOT_ALLOWED. Appelez toujours employer.get_candidate en premier lorsque le candidat a eu une interaction antérieure.
  • Verrouillage du contact : les champs de contact du candidat ne sont retournés que lorsque reviewStatus ∈ {SHORTLISTED, HIRED}. En dessous, les champs sont null.
  • employer.create_job est synchrone et prend 5 à 30 s (analyse Gemini). En cas de timeout client, ne soumettez PAS à nouveau rawText — récupérez via employer.list_jobs({ status: 'DRAFT' }) et choisissez la ligne la plus récente.
  • Mini-schéma complet : references/employer-catalog.md. Recettes : references/employer-recipes.md. Cas particuliers : references/employer-troubleshooting.md.

Références

Lisez à la demande selon l'intention :

  • references/candidate-catalog.md — mini-schémas des outils candidat (9)
  • references/candidate-recipes.md — recettes d'ordre d'appel candidat
  • references/candidate-troubleshooting.md — scénarios d'erreur côté candidat
  • references/employer-catalog.md — mini-schémas des outils employeur (19)
  • references/employer-recipes.md — recettes d'ordre d'appel employeur
  • references/employer-troubleshooting.md — scénarios d'erreur côté employeur
  • references/auth-flow.md — intégration candidat et employeur plus flux de clé sauvegardée
  • references/troubleshooting.md — problèmes MCP généraux / inter-rôles

Skills associés