convez.ai
MCP ServerIntegração & APIsIntermediário
work0r-ai

WorkorAI Agent Kit

work0r-ai/agent-kit

Instalador universal de skills MCP para marketplace de trabalho em agentes IA

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server universal para instalar skills e talentos WorkorAI em clientes de agentes como Claude, Codex, OpenCode e outros. Implementa um marketplace de trabalho com suporte simultâneo para candidatos (busca de emprego) e empregadores (recrutamento), com roteamento automático por papel de usuário e armazenamento seguro de credenciais.

Instalação

$npx convez-ai work0r-ai/agent-kit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar plataforma de recrutamento em clientes de agentes locais
  • Gerenciar fluxo de candidatos e empregadores com um único skill
  • Armazenar e rotear credenciais MCP por papel de usuário (candidato/empregador)

Veredito

Solução robusta e bem-documentada para marketplace de trabalho em agentes. Suporta múltiplos clientes e oferece experiência diferenciada por papel, mas tem escopo específico (recrutamento) e requer config manual por agente.

README

A tradução para o português deste README ainda está na fila.

WorkorAI Agent Kit

npm License: MIT Agent Skill

WorkorAI Agent Kit packages the workorai Agent Skill and a zero-dependency installer for WorkorAI MCP talent marketplace workflows.

It supports both sides of the marketplace through one skill:

  • Candidates ask prompts like найди мне работу, find me a job, or help me get hired; the skill guides them through onboarding, MCP key setup, and the candidate match tools.
  • Employers ask prompts like найди кандидатов, hire developers, post a job, or review applicants; the skill walks through the 18-tool employer MCP surface (job lifecycle, candidate discovery, invitations, applicants review).

Both roles share one skill name (workorai) and one credential helper, with role-aware storage slots so a dual-role user can keep both keys.

Install

Install the skill and write MCP config for supported local agents:

npx @workorai/agent-kit install

Install for one client:

npx @workorai/agent-kit install --agent codex
npx @workorai/agent-kit install --agent claude
npx @workorai/agent-kit install --agent opencode
npx @workorai/agent-kit install --agent cursor
npx @workorai/agent-kit install --agent openclaw
npx @workorai/agent-kit install --agent qwen
npx @workorai/agent-kit install --agent antigravity
npx @workorai/agent-kit install --agent deepcode

Use a local development MCP endpoint:

npx @workorai/agent-kit install --endpoint http://127.0.0.1:3001/mcp

For isolated installer tests, set WORKORAI_AGENT_HOME to a temporary directory:

WORKORAI_AGENT_HOME=/tmp/workorai-agent-home npx @workorai/agent-kit install

After install, restart the agent client and ask:

find me a job

What Is Included

  • skills/workorai/SKILL.md - canonical Agent Skill (thin role router).
  • skills/workorai/agents/openai.yaml - Codex/OpenAI-style UI metadata.
  • skills/workorai/references/
    • candidate-catalog.md - candidate tool mini-schemas
    • employer-catalog.md - 18 employer tool mini-schemas
    • employer-recipes.md - hire / review / lifecycle recipes
    • employer-troubleshooting.md - employer-side error scenarios
    • auth-flow.md - candidate and employer onboarding + saved-key flow
    • troubleshooting.md - cross-role MCP transport / saved-key issues
  • skills/workorai/scripts/credential-store.mjs - role-aware consent-based local MCP key storage.
  • bin/workorai-agent.mjs - installer, MCP config writer, diagnostics, and credential command wrapper.

Supported Targets

Agent targetSkill locationMCP config
codex~/.codex/skills/workorai~/.codex/config.toml
claude~/.claude/skills/workorai~/.claude.json
opencode~/.config/opencode/skills/workorai~/.config/opencode/config.json
cursor~/.cursor/skills/workoraiUse WorkorAI MCP config supported by your Cursor setup
openclaw~/.agents/skills/workorai~/.agents/mcp.json
qwen~/.qwen/skills/workoraiConfigure MCP according to your Qwen Code setup
antigravity~/.gemini/antigravity/skills/workoraiConfigure MCP according to your Antigravity setup
deepcode~/.agents/skills/workorai~/.agents/mcp.json
generic~/.agents/skills/workorai~/.agents/mcp.json

The default install command installs a canonical copy at ~/.agents/skills/workorai and links or copies compatible client locations.

Commands

npx @workorai/agent-kit --help
npx @workorai/agent-kit install --dry-run
npx @workorai/agent-kit configure --agent all
npx @workorai/agent-kit print-config --agent codex
npx @workorai/agent-kit doctor --agent all
npx @workorai/agent-kit credential get

Credentials

The skill reads WorkorAI MCP keys role-aware. Default --role is candidate; pass --role=employer for the employer slot.

Candidate read order:

  1. WORKORAI_MCP_API_KEY
  2. OS secret store (account candidate)
  3. Shared local fallback at ~/.config/workorai/mcp-token

Employer read order:

  1. WORKORAI_EMPLOYER_MCP_API_KEY
  2. OS secret store (account employer)
  3. Shared local fallback at ~/.config/workorai/mcp-token-employer

Save with OS storage by default:

npx @workorai/agent-kit credential save                  # candidate (default)
npx @workorai/agent-kit credential save --role=employer

Use best-effort storage for headless agent sessions:

npx @workorai/agent-kit credential save --best-effort --role=candidate
npx @workorai/agent-kit credential save --best-effort --role=employer

Use the shared file fallback only after explicit user consent:

npx @workorai/agent-kit credential save --shared-file --role=<role>

Never put real WorkorAI MCP keys in repositories, screenshots, issue text, or MCP config. Redact keys as wai_[REDACTED].

Skill Hub Compatibility

This repository is structured for direct ingestion by major skill surfaces:

  • GitHub: readable standalone repository with license, security policy, CI, and contribution docs.
  • npm: @workorai/agent-kit CLI package for one-command install.
  • Codex/OpenAI-style skills: canonical folder at skills/workorai plus agents/openai.yaml.
  • Claude Code: standard SKILL.md folder installable into .claude/skills/ or ~/.claude/skills/.
  • OpenCode: standard SKILL.md folder installable into .opencode/skills/, ~/.config/opencode/skills/, or Claude-compatible locations.
  • Cursor: standard SKILL.md folder installable into .cursor/skills/ or ~/.cursor/skills/.
  • Qwen Code: standard SKILL.md folder installable into .qwen/skills/ or ~/.qwen/skills/.
  • Antigravity / Gemini Antigravity: standard SKILL.md folder installable into ~/.gemini/antigravity/skills/.
  • Deep Code / DeepSeek: standard SKILL.md folder installable into .deepcode/skills/ or the shared ~/.agents/skills/.
  • skills.re and similar registries: root skills/ folder with at least one skill directory.
  • Cursor/Windsurf-compatible hubs: canonical SKILL.md folder plus generic MCP config notes in registry/.

Submission notes live in registry/submission-checklist.md.

Candidate Onboarding

When personalized MCP access is not available, the skill guides the user through:

  1. Register and sign in: https://workorai.com/candidate/login
  2. Complete profile: https://workorai.com/candidate/profile
  3. Complete the profile interview and wait for evaluation.
  4. Generate or copy the MCP key: https://workorai.com/candidate/home?tab=mcp
  5. Paste the key into the agent session for immediate candidate.search_jobs use.

Employer Onboarding

When the user asks to hire, post jobs, or review candidates, the skill guides them through:

  1. Sign in: https://workorai.com/employer/login
  2. Open the Employer Dashboard and locate the Employer MCP card: https://workorai.com/employer/dashboard
  3. Generate or copy the MCP key from the card.
  4. Paste the key into the agent session for immediate employer.* tool use.
  5. Save with --role=employer for future hiring searches.

The 18 employer tools cover the full hire-to-review lifecycle. See skills/workorai/references/employer-catalog.md for the mini-schemas and skills/workorai/references/employer-recipes.md for the four calling-order recipes (hire from a specific job, free-form hire, funnel review, pending-invites cleanup) plus the job lifecycle (create → publish → close → archive).

Development

npm run validate
npm run smoke
npm pack --dry-run

npm run smoke installs into a temporary directory only and does not touch user agent config.

Release

  1. Update CHANGELOG.md.
  2. Run validation, smoke, and npm pack --dry-run.
  3. Tag the GitHub release.
  4. Publish npm:
npm publish --access public
  1. Submit the repository URL to relevant skill hubs using registry/submission-checklist.md.

License

MIT. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados