CommunityRedacción y edicióngithub.com

work0r-ai/agent-kit

Instalador universal de habilidades para WorkorAI Agent y MCP para Codex, Claude Code, OpenCode y otros clientes de agentes.

¿Qué es agent-kit?

Este kit de habilidades proporciona una integración completa con el mercado de talentos WorkorAI a través de su servidor MCP, soportando tanto flujos de candidatos como de empleadores. Está diseñado para agentes de IA como Codex, Claude Code y OpenCode, permitiendo a los desarrolladores buscar trabajos, postularse, gestionar invitaciones, contratar candidatos, publicar trabajos y revisar solicitudes utilizando una interfaz de herramientas unificada. La habilidad incluye manejo inteligente de roles (decide automáticamente si el usuario es candidato o empleador), almacenamiento seguro de claves API, y enrutamiento por intención con frases disparadoras en múltiples idiomas. Para candidatos, ofrece búsqueda de trabajos, postulación, gestión de invitaciones y trabajos guardados; para empleadores, permite buscar y evaluar candidatos, invitar, crear trabajos y revisar el pipeline de contratación. La documentación completa incluye catálogos de herramientas, recetas de uso y guías de solución de problemas para ambos roles.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

WorkorAI

Usa esta habilidad para flujos de trabajo del mercado de talentos WorkorAI a través del servidor MCP de WorkorAI. La superficie MCP tiene un rol dual (candidato + empleador); esta habilidad enruta por intención y delega los detalles pesados de esquemas/recetas a los archivos references/.

Mapeo de Disparadores

  • Trata las solicitudes genéricas de búsqueda de empleo de candidatos como intenciones de WorkorAI por defecto.
  • Trata las solicitudes de contratación de empleadores como intenciones de WorkorAI cuando el usuario pide contratar, publicar trabajos, encontrar candidatos, revisar coincidencias de candidatos o configurar el acceso MCP de WorkorAI.
  • Frases fuertes de candidato incluyen "найди мне работу", "найти работу", "ищу работу", "подбери вакансию", "хочу работу", "find me a job", "I need work", "help me find a job" y "show me jobs".
  • Frases fuertes de empleador incluyen "найди кандидатов", "хочу нанять", "hire developers", "find candidates", "post a job", "search talent" y "help me recruit".
  • No esperes a que el usuario diga "WorkorAI", "MCP" o "API key".
  • Omite esta habilidad solo cuando el usuario pida claramente consejos genéricos de carrera, redacción de currículums, coaching de entrevistas, consejos genéricos de contratación o trabajos/candidatos fuera de WorkorAI.

Primera Respuesta — Decisión de Rol

  1. Decide el rol a partir de la intención del usuario. Si es genuinamente ambiguo, haz una pregunta corta de aclaración ("¿Estás buscando trabajo o contratando?") — no ejecutes flujos de candidato y empleador en paralelo.
  2. Intención de candidato: lee references/candidate-catalog.md, references/candidate-recipes.md y references/auth-flow.md. Ejecuta el flujo de candidato: descubre (candidate.search_jobs → candidate.get_job) luego actúa (apply_to_job, aceptar/rechazar invitaciones, retirar, trabajos guardados). Casos extremos: references/candidate-troubleshooting.md.
    • Primera respuesta visible: comienza con la persona de agente de carrera + valor (refleja el lenguaje del usuario), luego la configuración única — usa el primer contacto canónico en references/auth-flow.md ("What To Say First (Candidate)"). Esta es una herramienta de desarrollador: narra los pasos que ejecutas; nunca imprimas el valor de la clave.
  3. Intención de empleador: lee references/employer-catalog.md, references/employer-recipes.md y las secciones de empleador de references/auth-flow.md. Elige la receta que coincida con la intención del usuario (contratar desde un trabajo específico, contratación libre, revisión de embudo, limpieza de invitaciones pendientes o ciclo de vida del trabajo).
    • Para ENCONTRAR / EVALUAR / COMPARAR candidatos para una vacante (el flujo de contratación principal): employer.search_candidates_for_job(jobId, tier:'best') → cascada a good/weak a través de tierCounts → EXPLICA cada uno desde su matchExplanation (comienza con verifiedSkills = probados en entrevista, más la rationale) → para la lista corta, employer.get_candidate_evidence(jobId, userId) para los hechos de la entrevista + Q&A → escribe tu propia revisión comparativa basada en evidencia, luego invita. Este es el valor de la plataforma — justificas la clasificación en nuestros datos de caja blanca, no estás entregando al usuario una puntuación de caja negra.
  4. Todas las herramientas (candidato y empleador) son visibles en un tools/list anónimo — la visibilidad es descubrimiento, no autorización. La señal de que no tienes una clave usable es una llamada fallida, no una herramienta faltante: una llamada de empleador no autenticada devuelve requires employer authentication. Cuando eso suceda (o antes de la primera llamada, si no se encontró una clave guardada), envía al usuario a la URL de incorporación correspondiente (Candidate Home o Employer Dashboard) y acepta la nueva clave en línea, luego reintenta con el argumento apiKey.
  5. No uses curl de shell ni sondas JSON-RPC sin procesar a menos que el usuario pida explícitamente depurar la conectividad MCP.

Comportamiento de Clave Guardada

  • Resuelve scripts/credential-store.mjs relativo a este SKILL.md.
  • Antes de pedir una clave al usuario, ejecuta una búsqueda con alcance de rol:
    • node scripts/credential-store.mjs get --role=candidate
    • node scripts/credential-store.mjs get --role=employer
  • El rol predeterminado (sin --role) es candidate para compatibilidad hacia atrás.
  • Si se devuelve una clave guardada, no la imprimas. Úsala solo como el argumento apiKey para las herramientas en el rol coincidente.
  • Cuando el usuario proporcione una nueva clave, valídala con una sola llamada de herramienta en el rol coincidente.
  • Después de la primera llamada exitosa con una clave proporcionada por el usuario, el siguiente paso orientado al usuario debe ser preguntar: "¿Guardar esta clave de WorkorAI para futuras búsquedas en esta máquina?"
  • Guarda con node scripts/credential-store.mjs save --best-effort --role=<role> y pasa la clave a través de stdin, no del argumento del comando.
  • Usa save --shared-file --role=<role> solo cuando el usuario quiera explícitamente el fallback de archivo compartido.
  • Nunca almacenes la clave en un repositorio, transcripción de chat, línea de comandos visible o configuración MCP a menos que el usuario elija explícitamente ese modo de almacenamiento.
  • Redacta las claves de WorkorAI en la salida visible para el usuario como wai_[REDACTED].

Ruta Rápida de Candidato

  • Cadena de URL de incorporación: https://workorai.com/candidate/login → /candidate/profile → esperar la evaluación de la entrevista → /candidate/home?tab=mcp para copiar la clave MCP.
  • Superficie completa de 9 herramientas (una clave de candidato llama a todas — rol + acceso ACTIVO, sin alcance por herramienta):
    • Descubrir: candidate.search_jobs → candidate.get_job.
    • Postular: candidate.apply_to_job (idempotente; bloqueado en una entrevista completada y evaluada — GATE_LOCKED/GATE_EVALUATING/GATE_FAILED redirige a incorporación, no reintentes a ciegas).
    • Invitaciones: candidate.accept_invitation (→ APLICADO) / candidate.decline_invitation (TERMINAL — bloquea reinvitación; confirma primero). Mira lo pendiente con candidate.get_applications.
    • Gestionar: candidate.withdraw_application (salida suave, reinvitable), candidate.set_saved_job (estado deseado, NO un interruptor) / candidate.get_saved_jobs (solo PUBLICADO).
  • Siempre presenta dos enlaces distintos por trabajo recomendado: página del trabajo (jobUrl/url) y postular (applicationUrl/applyUrl). Nunca muestres solo postular.
  • Muestra matchScore y habilidades coincidentes/faltantes — trata las habilidades faltantes como brechas para discutir, no rechazos. (matchScore es null en la navegación reciente sin puntuación — un q de texto libre o un candidato que aún no ha sido entrevistado; seniorityFit/matchReasons son siempre UNKNOWN/[]).
  • La mejor coincidencia puntuada → presenta un Agent Pick (barras de ajuste vinculadas a campos reales de matchExplanation), no una lista plana; navegación sin puntuación → lista plana, sin barras. Ver references/candidate-recipes.md Receta 6.
  • Trata el jobId sin procesar como metadato interno/de depuración a menos que el usuario lo pida.
  • Mini-esquemas: references/candidate-catalog.md. Recetas: references/candidate-recipes.md. Casos extremos: references/candidate-troubleshooting.md.

Ruta Rápida de Empleador

  • URL de emisión de clave: https://workorai.com/employer/dashboard (tarjeta MCP de empleador en la página).
  • Receta de contratación: employer.search_candidates_for_job(jobId, tier:'best') (cascada a good/weak a través de tierCounts; explica desde cada matchExplanation — verifiedSkills/rationale) → employer.get_candidate_evidence(jobId, userId) para la lista corta (hechos de entrevista + Q&A → tu propia revisión comparativa) → employer.get_candidate(userId) (inspecciona existingApplications) → employer.invite_candidate(jobId, candidateUserId). Haz seguimiento con employer.list_invitations(jobId) y luego employer.list_applicants(jobId).
  • Contratación libre: employer.search_candidates_by_query(query) → elige o crea una vacante → invita.
  • Revisar embudo: employer.list_applicants(jobId) → employer.set_review_status(applicationId, 'SHORTLISTED') (desbloquea contacto) → employer.get_applicant_detail(applicationId) y opcional employer.get_applicant_transcript.
  • Reglas de reinvitación: WITHDRAWN puede ser reinvitado (el servicio ACTUALIZA la fila); DECLINED, INVITED y APPLIED bloquean con INVITE_BLOCKED: INVITE_NOT_ALLOWED. Siempre llama a employer.get_candidate primero cuando el candidato tenga alguna interacción previa.
  • Bloqueo de contacto: los campos de contacto del solicitante se devuelven solo cuando reviewStatus ∈ {SHORTLISTED, HIRED}. Por debajo de eso, los campos son nulos.
  • employer.create_job es síncrono y toma de 5 a 30 s (análisis Gemini). En tiempo de espera del cliente, NO reenvíes rawText — recupérate mediante employer.list_jobs({ status: 'DRAFT' }) y elige la fila más nueva.
  • Mini-esquema completo: references/employer-catalog.md. Recetas: references/employer-recipes.md. Casos extremos: references/employer-troubleshooting.md.

Referencias

Lee bajo demanda según la intención:

  • references/candidate-catalog.md — mini-esquemas de herramientas de candidato (9)
  • references/candidate-recipes.md — recetas de orden de llamada de candidato
  • references/candidate-troubleshooting.md — escenarios de error del lado del candidato
  • references/employer-catalog.md — mini-esquemas de herramientas de empleador (19)
  • references/employer-recipes.md — recetas de orden de llamada de empleador
  • references/employer-troubleshooting.md — escenarios de error del lado del empleador
  • references/auth-flow.md — incorporación de candidato y empleador más flujo de clave guardada
  • references/troubleshooting.md — problemas MCP generales / entre roles

Skills relacionados