{
  "markdown": "# WorkorAI Agent Kit\n\n[![npm](https://img.shields.io/npm/v/@workorai/agent-kit.svg)](https://www.npmjs.com/package/@workorai/agent-kit)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Agent Skill](https://img.shields.io/badge/agent-skill-0F766E.svg)](skills/workorai/SKILL.md)\n\nWorkorAI Agent Kit packages the `workorai` Agent Skill and a zero-dependency installer for WorkorAI MCP talent marketplace workflows.\n\nIt supports both sides of the marketplace through one skill:\n\n- **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.\n- **Employers** ask prompts like `найди кандидатов`, `hire developers`, `post a job`, or `review applicants`; the skill walks through the 19-tool employer MCP surface (job lifecycle, candidate discovery, invitations, applicants review).\n\nBoth roles share one skill name (`workorai`) and one credential helper, with role-aware storage slots so a dual-role user can keep both keys.\n\n## Install\n\nInstall the skill and write MCP config for supported local agents:\n\n```bash\nnpx @workorai/agent-kit install\n```\n\nInstall for one client:\n\n```bash\nnpx @workorai/agent-kit install --agent codex\nnpx @workorai/agent-kit install --agent claude\nnpx @workorai/agent-kit install --agent opencode\nnpx @workorai/agent-kit install --agent cursor\nnpx @workorai/agent-kit install --agent openclaw\nnpx @workorai/agent-kit install --agent qwen\nnpx @workorai/agent-kit install --agent antigravity\nnpx @workorai/agent-kit install --agent deepcode\n```\n\nUse a local development MCP endpoint:\n\n```bash\nnpx @workorai/agent-kit install --endpoint http://127.0.0.1:3001/mcp\n```\n\nFor isolated installer tests, set `WORKORAI_AGENT_HOME` to a temporary directory:\n\n```bash\nWORKORAI_AGENT_HOME=/tmp/workorai-agent-home npx @workorai/agent-kit install\n```\n\nAfter install, restart the agent client and ask:\n\n```text\nfind me a job\n```\n\n## What Is Included\n\n- `skills/workorai/SKILL.md` - canonical Agent Skill (thin role router).\n- `skills/workorai/agents/openai.yaml` - Codex/OpenAI-style UI metadata.\n- `skills/workorai/references/`\n  - `candidate-catalog.md` - candidate tool mini-schemas\n  - `candidate-recipes.md` - candidate calling-order recipes (incl. the Agent Pick result presentation)\n  - `candidate-troubleshooting.md` - candidate-side error scenarios\n  - `employer-catalog.md` - 19 employer tool mini-schemas\n  - `employer-recipes.md` - hire / review / lifecycle recipes\n  - `employer-troubleshooting.md` - employer-side error scenarios\n  - `auth-flow.md` - candidate and employer onboarding + saved-key flow\n  - `troubleshooting.md` - cross-role MCP transport / saved-key issues\n- `skills/workorai/scripts/credential-store.mjs` - role-aware consent-based local MCP key storage.\n- `bin/workorai-agent.mjs` - installer, MCP config writer, diagnostics, and credential command wrapper.\n\n## Supported Targets\n\n| Agent target | Skill location | MCP config |\n| --- | --- | --- |\n| `codex` | `~/.codex/skills/workorai` | `~/.codex/config.toml` |\n| `claude` | `~/.claude/skills/workorai` | `~/.claude.json` |\n| `opencode` | `~/.config/opencode/skills/workorai` | `~/.config/opencode/config.json` |\n| `cursor` | `~/.cursor/skills/workorai` | Use WorkorAI MCP config supported by your Cursor setup |\n| `openclaw` | `~/.agents/skills/workorai` | `~/.agents/mcp.json` |\n| `qwen` | `~/.qwen/skills/workorai` | Configure MCP according to your Qwen Code setup |\n| `antigravity` | `~/.gemini/antigravity/skills/workorai` | Configure MCP according to your Antigravity setup |\n| `deepcode` | `~/.agents/skills/workorai` | `~/.agents/mcp.json` |\n| `generic` | `~/.agents/skills/workorai` | `~/.agents/mcp.json` |\n\nThe default `install` command installs a canonical copy at `~/.agents/skills/workorai` and links or copies compatible client locations.\n\n## Commands\n\n```bash\nnpx @workorai/agent-kit --help\nnpx @workorai/agent-kit install --dry-run\nnpx @workorai/agent-kit configure --agent all\nnpx @workorai/agent-kit print-config --agent codex\nnpx @workorai/agent-kit doctor --agent all\nnpx @workorai/agent-kit credential get\n```\n\n## Credentials\n\nThe skill reads WorkorAI MCP keys role-aware. Default `--role` is `candidate`; pass `--role=employer` for the employer slot.\n\nCandidate read order:\n\n1. `WORKORAI_MCP_API_KEY`\n2. OS secret store (account `candidate`)\n3. Shared local fallback at `~/.config/workorai/mcp-token`\n\nEmployer read order:\n\n1. `WORKORAI_EMPLOYER_MCP_API_KEY`\n2. OS secret store (account `employer`)\n3. Shared local fallback at `~/.config/workorai/mcp-token-employer`\n\nSave with OS storage by default:\n\n```bash\nnpx @workorai/agent-kit credential save                  # candidate (default)\nnpx @workorai/agent-kit credential save --role=employer\n```\n\nUse best-effort storage for headless agent sessions:\n\n```bash\nnpx @workorai/agent-kit credential save --best-effort --role=candidate\nnpx @workorai/agent-kit credential save --best-effort --role=employer\n```\n\nUse the shared file fallback only after explicit user consent:\n\n```bash\nnpx @workorai/agent-kit credential save --shared-file --role=<role>\n```\n\nNever put real WorkorAI MCP keys in repositories, screenshots, issue text, or MCP config. Redact keys as `wai_[REDACTED]`.\n\n## Skill Hub Compatibility\n\nThis repository is structured for direct ingestion by major skill surfaces:\n\n- **GitHub**: readable standalone repository with license, security policy, CI, and contribution docs.\n- **npm**: `@workorai/agent-kit` CLI package for one-command install.\n- **Codex/OpenAI-style skills**: canonical folder at `skills/workorai` plus `agents/openai.yaml`.\n- **Claude Code**: standard `SKILL.md` folder installable into `.claude/skills/` or `~/.claude/skills/`.\n- **OpenCode**: standard `SKILL.md` folder installable into `.opencode/skills/`, `~/.config/opencode/skills/`, or Claude-compatible locations.\n- **Cursor**: standard `SKILL.md` folder installable into `.cursor/skills/` or `~/.cursor/skills/`.\n- **Qwen Code**: standard `SKILL.md` folder installable into `.qwen/skills/` or `~/.qwen/skills/`.\n- **Antigravity / Gemini Antigravity**: standard `SKILL.md` folder installable into `~/.gemini/antigravity/skills/`.\n- **Deep Code / DeepSeek**: standard `SKILL.md` folder installable into `.deepcode/skills/` or the shared `~/.agents/skills/`.\n- **skills.re and similar registries**: root `skills/` folder with at least one skill directory.\n- **Cursor/Windsurf-compatible hubs**: canonical `SKILL.md` folder plus generic MCP config notes in `registry/`.\n\nSubmission notes live in [`registry/submission-checklist.md`](registry/submission-checklist.md).\n\n## Candidate Onboarding\n\nWhen personalized MCP access is not available, the skill guides the user through:\n\n1. Register and sign in: <https://workorai.com/candidate/login>\n2. Complete profile: <https://workorai.com/candidate/profile>\n3. Complete the profile interview and wait for evaluation.\n4. Generate or copy the MCP key: <https://workorai.com/candidate/home?tab=mcp>\n5. Paste the key into the agent session for immediate `candidate.search_jobs` use.\n\n## Employer Onboarding\n\nWhen the user asks to hire, post jobs, or review candidates, the skill guides them through:\n\n1. Sign in: <https://workorai.com/employer/login>\n2. Open the Employer Dashboard and locate the Employer MCP card: <https://workorai.com/employer/dashboard>\n3. Generate or copy the MCP key from the card.\n4. Paste the key into the agent session for immediate `employer.*` tool use.\n5. Save with `--role=employer` for future hiring searches.\n\nThe 19 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).\n\n## Development\n\n```bash\nnpm run validate\nnpm run smoke\nnpm pack --dry-run\n```\n\n`npm run smoke` installs into a temporary directory only and does not touch user agent config.\n\n## Release\n\n1. Update `CHANGELOG.md`.\n2. Run validation, smoke, and `npm pack --dry-run`.\n3. Tag the GitHub release.\n4. Publish npm:\n\n```bash\nnpm publish --access public\n```\n\n5. Submit the repository URL to relevant skill hubs using `registry/submission-checklist.md`.\n\n## License\n\nMIT. See [`LICENSE`](LICENSE).\n",
  "bytes": 8443,
  "sha": "5adb4d96235b11c5fffa513e7ad640f87780cdae076ad6f2e445577186789e4c",
  "repo_slug": "work0r-ai/agent-kit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_aitmpl_career_workorai_8142bdcf/readme"
}