CommunitySchreiben & Editierengithub.com

work0r-ai/agent-kit

Universelles WorkorAI Agenten-Skill und MCP-Installer für Codex, Claude Code, OpenCode und andere Agenten-Clients.

Was ist agent-kit?

Dieses Skill integriert die WorkorAI Talent-Marktplatz-Plattform direkt in KI-Agenten wie Claude Code, Cursor, Codex und OpenCode. Es ermöglicht sowohl Kandidaten, die einen Job suchen, als auch Arbeitgebern, die einstellen möchten, die vollständige WorkorAI-Funktionalität über MCP (Model Context Protocol) zu nutzen. Der Agent navigiert anhand der Benutzerabsicht (Jobsuche oder Einstellung) durch einen dualen Rollen-Workflow, liest bei Bedarf Referenzdateien (z. B. Kataloge, Rezepte, Fehlerbehebung) und führt die entsprechenden Aktionen aus – von der Jobsuche und Bewerbung (Kandidat) bis hin zur Kandidatensuche, Einladung und Bewerberverwaltung (Arbeitgeber). Ein wichtiges Merkmal ist die sichere Verwaltung von API-Schlüsseln: Der Agent speichert Schlüssel verschlüsselt im Dateisystem, redigiert sie in der Ausgabe und fragt den Benutzer, ob der Schlüssel gespeichert werden soll. Das Skill bietet außerdem intelligentes Ranking mit Erklärungen zu Fähigkeiten, die in Vorstellungsgesprächen nachgewiesen wurden, sowie eine intuitive Entscheidungsunterstützung – es präsentiert keine Blackbox-Bewertungen, sondern begründete Vergleiche.

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

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

WorkorAI

Verwende dieses Skill für WorkorAI Talentmarktplatz-Workflows über den WorkorAI MCP-Server. Die MCP-Oberfläche hat zwei Rollen (Kandidat + Arbeitgeber); dieses Skill leitet basierend auf der Absicht und delegiert die detaillierten Schema-/Rezeptdetails an die references/-Dateien.

Trigger-Zuordnung

  • Behandle generische Anfragen zur Jobsuche eines Kandidaten standardmäßig als WorkorAI-Intents.
  • Behandle Anfragen zur Einstellung von Arbeitgebern als WorkorAI-Intents, wenn der Benutzer nach Einstellung, Stellenausschreibung, Kandidatensuche, Prüfung von Kandidaten-Matches oder Konfiguration des WorkorAI MCP-Zugriffs fragt.
  • Starke Kandidaten-Schlüsselwörter sind u. a. "найди мне работу", "найти работу", "ищу работу", "подбери вакансию", "хочу работу", "find me a job", "I need work", "help me find a job" und "show me jobs".
  • Starke Arbeitgeber-Schlüsselwörter sind u. a. "найди кандидатов", "хочу нанять", "hire developers", "find candidates", "post a job", "search talent", und "help me recruit".
  • Warte nicht darauf, dass der Benutzer "WorkorAI", "MCP" oder "API key" sagt.
  • Überspringe dieses Skill nur, wenn der Benutzer eindeutig nach allgemeiner Karriereberatung, Lebenslauf-Erstellung, Coaching für Vorstellungsgespräche, allgemeiner Einstellungsberatung oder Jobs/Kandidaten außerhalb von WorkorAI fragt.

Erste Antwort – Rollenentscheidung

  1. Entscheide die Rolle anhand der Benutzerabsicht. Bei echter Mehrdeutigkeit stelle eine kurze klärende Frage ("Suchen Sie einen Job oder möchten Sie einstellen?") – führe Kandidaten- und Arbeitgeber-Workflows nicht parallel aus.
  2. Kandidaten-Absicht: Lies references/candidate-catalog.md, references/candidate-recipes.md und references/auth-flow.md. Führe den Kandidaten-Workflow aus: Entdecken (candidate.search_jobs → candidate.get_job) dann handeln (apply_to_job, Einladungen annehmen/ablehnen, zurückziehen, gespeicherte Jobs). Randfälle: references/candidate-troubleshooting.md.
    • Erste sichtbare Antwort: Beginne mit der Karriere-Agenten-Persona + Nutzen (spiegle die Sprache des Benutzers), dann die einmalige Einrichtung – verwende den kanonischen Erste-Kontakt in references/auth-flow.md ("What To Say First (Candidate)"). Dies ist ein Entwicklerwerkzeug: Erzähle die Schritte, die du ausführst; gib niemals den Schlüsselwert aus.
  3. Arbeitgeber-Absicht: Lies references/employer-catalog.md, references/employer-recipes.md und die Arbeitgeber-Abschnitte von references/auth-flow.md. Wähle das Rezept, das der Benutzerabsicht entspricht (Einstellung aus bestimmter Stelle, freie Einstellung, Trichterprüfung, ausstehende Einladungen bereinigen oder Stellen-Lebenszyklus).
    • Zum FINDEN / BEWERTEN / VERGLEICHEN von Kandidaten für eine Stelle (der Kern des Einstellungs-Workflows): employer.search_candidates_for_job(jobId, tier:'best') → Kaskade zu good/weak via tierCounts → Erkläre jeden anhand von dessen matchExplanation (beginne mit verifiedSkills = im Vorstellungsgespräch nachgewiesen, plus der rationale) → für die Shortlist: employer.get_candidate_evidence(jobId, userId) für die Interview-Fakten + Q&A → schreibe deine eigene evidenzbasierte Vergleichsbewertung, dann lade ein. Dies ist der Wert der Plattform – du begründest das Ranking auf unseren transparenten Daten, du gibst dem Benutzer keine Blackbox-Bewertung.
  4. Alle Werkzeuge (Kandidat und Arbeitgeber) sind in einem anonymen tools/list sichtbar – Sichtbarkeit ist Entdeckung, nicht Autorisierung. Das Signal, dass du keinen verwendbaren Schlüssel hast, ist ein fehlgeschlagener Aufruf, nicht ein fehlendes Werkzeug: Ein nicht authentifizierter Arbeitgeber-Aufruf gibt requires employer authentication zurück. Wenn das passiert (oder vor dem ersten Aufruf, wenn kein gespeicherter Schlüssel gefunden wurde), sende den Benutzer zur passenden Onboarding-URL (Candidate Home oder Employer Dashboard) und akzeptiere den neuen Schlüssel inline, dann wiederhole den Vorgang mit dem apiKey-Argument.
  5. Verwende kein Shell curl oder rohes JSON-RPC-Sondieren, es sei denn, der Benutzer bittet explizit um Debugging der MCP-Konnektivität.

Gespeichertes Schlüsselverhalten

  • Lese scripts/credential-store.mjs relativ zu dieser SKILL.md auf.
  • Bevor du den Benutzer nach einem Schlüssel fragst, führe eine rollenspezifische Suche durch:
    • node scripts/credential-store.mjs get --role=candidate
    • node scripts/credential-store.mjs get --role=employer
  • Standardrolle (ohne --role) ist candidate für Rückwärtskompatibilität.
  • Wenn ein gespeicherter Schlüssel zurückgegeben wird, gib ihn nicht aus. Verwende ihn nur als apiKey-Argument für Werkzeuge der passenden Rolle.
  • Wenn der Benutzer einen neuen Schlüssel bereitstellt, validiere ihn mit einem einzigen Werkzeugaufruf in der passenden Rolle.
  • Nach dem ersten erfolgreichen Aufruf mit einem vom Benutzer bereitgestellten Schlüssel muss der nächste benutzerseitige Schritt sein: "Diesen WorkorAI-Schlüssel für zukünftige Suchen auf diesem Rechner speichern?"
  • Speichere mit node scripts/credential-store.mjs save --best-effort --role=<role> und übergib den Schlüssel über stdin, nicht über das Befehlsargument.
  • Verwende save --shared-file --role=<role> nur, wenn der Benutzer explizit den Shared-File-Fallback wünscht.
  • Speichere den Schlüssel niemals in einem Repository, Chat-Transkript, sichtbarer Befehlszeile oder MCP-Konfiguration, es sei denn, der Benutzer wählt diesen Speichermodus explizit aus.
  • Redigiere WorkorAI-Schlüssel in der benutzersichtbaren Ausgabe als wai_[REDACTED].

Kandidaten-Schnellpfad

  • Onboarding-URL-Kette: https://workorai.com/candidate/login → /candidate/profile → warte auf die Interview-Bewertung → /candidate/home?tab=mcp um den MCP-Schlüssel zu kopieren.
  • Vollständige 9-Tool-Oberfläche (ein Kandidatenschlüssel ruft alle auf – Rolle + AKTIVER Zugriff, kein Pro-Tool-Bereich):
    • Entdecken: candidate.search_jobs → candidate.get_job.
    • Bewerben: candidate.apply_to_job (idempotent; geschützt durch ein abgeschlossenes + bewertetes Interview – GATE_LOCKED/GATE_EVALUATING/GATE_FAILED leiten zurück zum Onboarding, nicht blind wiederholen).
    • Einladungen: candidate.accept_invitation (→ APPLIED) / candidate.decline_invitation (TERMINAL – blockiert Neueinladung; vorher bestätigen). Siehe, was aussteht mit candidate.get_applications.
    • Verwalten: candidate.withdraw_application (sanfter Ausstieg, wieder einladbar), candidate.set_saved_job (gewünschter Zustand, KEIN Umschalter) / candidate.get_saved_jobs (nur VERÖFFENTLICHT).
  • Zeige immer zwei getrennte Links pro empfohlenem Job an: Job-Seite (jobUrl/url) und Bewerbung (applicationUrl/applyUrl). Zeige niemals nur die Bewerbung.
  • Zeige matchScore und übereinstimmende/fehlende Fähigkeiten an – behandle fehlende Fähigkeiten als Lücken zum Besprechen, nicht als Ablehnungen. (matchScore ist null bei der chronologischen Suche ohne Punktzahl – eine Freitext-q oder ein noch nicht interviewter Kandidat; seniorityFit/matchReasons sind immer UNKNOWN/[].)
  • Stärkster bewerteter Treffer → präsentiere eine Agent Pick (Passungsbalken gebunden an echte matchExplanation-Felder), keine flache Liste; Chronologische Suche ohne Punktzahl → einfache Liste, keine Balken. Siehe references/candidate-recipes.md Rezept 6.
  • Behandle rohe jobId als interne/Debug-Metadaten, es sei denn, der Benutzer fragt danach.
  • Mini-Schemas: references/candidate-catalog.md. Rezepte: references/candidate-recipes.md. Randfälle: references/candidate-troubleshooting.md.

Arbeitgeber-Schnellpfad

  • Schlüsselausgabe-URL: https://workorai.com/employer/dashboard (Arbeitgeber-MCP-Karte auf der Seite).
  • Einstellungs-Rezept: employer.search_candidates_for_job(jobId, tier:'best') (Kaskade zu good/weak via tierCounts; erkläre anhand der jeweiligen matchExplanation — verifiedSkills/rationale) → employer.get_candidate_evidence(jobId, userId) für die Shortlist (Interview-Fakten + Q&A → deine eigene vergleichende Bewertung) → employer.get_candidate(userId) (prüfe existingApplications) → employer.invite_candidate(jobId, candidateUserId). Verfolge mit employer.list_invitations(jobId) und später employer.list_applicants(jobId).
  • Freie Einstellung: employer.search_candidates_by_query(query) → wähle oder erstelle eine Stelle → lade ein.
  • Trichter prüfen: employer.list_applicants(jobId) → employer.set_review_status(applicationId, 'SHORTLISTED') (entsperrt Kontakt) → employer.get_applicant_detail(applicationId) und optional employer.get_applicant_transcript.
  • Wiedereinladungsregeln: WITHDRAWN kann erneut eingeladen werden (der Dienst AKTUALISIERT die Zeile); DECLINED, INVITED und APPLIED blockieren alle mit INVITE_BLOCKED: INVITE_NOT_ALLOWED. Rufe immer zuerst employer.get_candidate auf, wenn der Kandidat eine vorherige Interaktion hatte.
  • Kontaktsperre: Bewerber-Kontaktfelder werden nur zurückgegeben, wenn reviewStatus ∈ {SHORTLISTED, HIRED}. Darunter sind die Felder null.
  • employer.create_job ist synchron und dauert 5-30 s (Gemini-Parsing). Bei Client-Timeout sende rawText NICHT erneut – stelle wieder her über employer.list_jobs({ status: 'DRAFT' }) und wähle die neueste Zeile.
  • Vollständiges Mini-Schema: references/employer-catalog.md. Rezepte: references/employer-recipes.md. Randfälle: references/employer-troubleshooting.md.

Referenzen

Bei Bedarf basierend auf der Absicht lesen:

  • references/candidate-catalog.md — Mini-Schemas der Kandidaten-Werkzeuge (9)
  • references/candidate-recipes.md — Aufruf-Rezepte für Kandidaten
  • references/candidate-troubleshooting.md — Fehlerszenarien auf Kandidatenseite
  • references/employer-catalog.md — Mini-Schemas der Arbeitgeber-Werkzeuge (19)
  • references/employer-recipes.md — Aufruf-Rezepte für Arbeitgeber
  • references/employer-troubleshooting.md — Fehlerszenarien auf Arbeitgeberseite
  • references/auth-flow.md — Onboarding für Kandidaten und Arbeitgeber plus gespeicherter Schlüssel-Workflow
  • references/troubleshooting.md — Allgemeine / rollenübergreifende MCP-Probleme

Verwandte Skills