# Talent De Platform

> Create CVs, search jobs, match skills, and negotiate via Work Deal Language. Several templates, PDF export, human-in-the-loop review. Free API for AI agents — basic use without API key, full features with Access-ID. Router skill — see domain-specific skills below for detailed instructions.

- Skill: `johnalbertini14-glitch/talent-de-platform` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/talent-de-platform`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/talent-de-platform/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: Free-to-use
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/johnalbertini14-glitch/talent-de-platform

---


# talent.de Platform

Create CVs, search jobs, match skills, and negotiate work conditions — all via API. Templates from classic PDFs to 3D worlds. Free for basic use.

## Agent Guidelines

> **HITL (Human In The Loop) is required.** You MUST choose: `"prefer_hitl": true` (human review — recommended) or `"skip_hitl": true` (direct creation — automated pipelines only). Omitting both returns a 400 error. If a human is present, ALWAYS use `"prefer_hitl": true`.

> **Data principle:** Only use data the requestor has explicitly provided or approved in this conversation.

> **Before sending:** Present a brief summary — name, title, email — and ask "Send it? Or should I change anything?"

> **Claim token:** Treat like a password. Share only with the requestor.

> **Keep it friendly.** See [User Communication](skills/cv-builder/SKILL.md#user-communication) for suggested messages at each step.

## Credentials

An **Access-ID** (`talent_agent_[a-z0-9]{4}`) unlocks higher rate limits and advanced skills. It is **optional** for CV Builder and Job Search, **required** for Template Create, Job Negotiate, and Template Contest.

Register (free, no user data transmitted):
```http
POST https://www.talent.de/api/agent/register
Content-Type: application/json

{ "agent_name": "my-agent" }
```

The Access-ID is also used as the HMAC secret for verifying `X-HITL-Signature` on callback webhooks. Store it securely — do not embed in client-side code or share across agents. See [Access System](skills/shared/access.md) for full details.

## Quick Start

```http
POST https://www.talent.de/api/agent/cv-simple
Content-Type: application/json

{
  "prefer_hitl": true,
  "cv_data": {
    "firstName": "Alex",
    "lastName": "Johnson",
    "title": "Software Engineer",
    "email": "alex@example.com"
  }
}
```

Response (202 — human review required):
```json
{
  "status": "human_input_required",
  "message": "Please confirm: is this CV for you?",
  "hitl": {
    "case_id": "review_a7f3b2c8d9e1f0g4",
    "review_url": "https://www.talent.de/en/hitl/review/review_a7f3b2c8d9e1f0g4?token=abc123...",
    "poll_url": "https://www.talent.de/api/hitl/cases/review_a7f3b2c8d9e1f0g4/status",
    "type": "confirmation"
  }
}
```

Present the `review_url` to the user. They choose slug, template, and approve. Poll `poll_url` for completion, continue through steps. See [CV Builder skill](skills/cv-builder/SKILL.md) for full flow.

## Skills

| Skill | Use when | Key endpoint |
|-------|----------|--------------|
| [CV Builder](skills/cv-builder/SKILL.md) | User wants to create, build, or export a CV | `POST /api/agent/cv-simple` |
| [Job Search](skills/job-search/SKILL.md) | User wants to find jobs or match their CV | `GET /api/agent/jobs` |
| [Job Negotiate](skills/job-negotiate/SKILL.md) | User wants to negotiate conditions or apply conditionally (coming soon) | `POST /api/agent/wdl/request` |
| [Template Create](skills/template-create/SKILL.md) | User wants to build a custom HTML template (coming soon) | `POST /api/agent/template` |
| [Template Contest](skills/template-contest/SKILL.md) | User wants to join template battles or showcases (coming soon) | — |

## Cross-Cutting References

- [Access System](skills/shared/access.md): Rate limits and Access-ID registration
- [Error Codes](skills/shared/errors.md): Error reference and troubleshooting
- [Privacy](skills/shared/privacy.md): Data handling and GDPR compliance

## Specs

- [agent.json](https://www.talent.de/.well-known/agent.json)
- [hitl.json](https://www.talent.de/.well-known/hitl.json)
- [llms.txt](https://www.talent.de/llms.txt)