# BRAINIAC Candidate Skill Compare

> BRAINIAC Candidate Skill Compare is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-17).

Compares a list of candidates' skills against specified skill requirements, returning per-candidate match status, years of experience, and skill gaps without inventing data.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/recruitment-operations/candidate-skill-compare?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-candidate-skill-compare-51f44dd7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CDWGdMcBaPZgGaz7uiYiz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-candidate-skill-compare-51f44dd7 -d '<json body>'
```

Example prompt: Compare these three candidates — Ada (4 years TypeScript, 2 years JS), Grace (6 years Python), and Sam (3 years TypeScript, 5 years Java) — against the required skills TypeScript and JavaScript, and tell me who matches, who's missing what, and how many years each has.

## When to prefer this

Use this endpoint when you need a structured, auditable comparison of multiple candidates' skills against a defined requirement list without any AI hallucination of credentials. It is especially suited for agent-driven recruiting workflows where explainability and no-invention guarantees matter. Prefer this over general-purpose LLM analysis when you need machine-readable match statuses, explicit years-of-experience figures, and built-in limitations disclosures.

## Known failure modes

- Missing required candidate id or name fields returns a validation error
- Candidate text or skills array exceeding max length or item limits returns a schema error
- Submitting zero candidates or an empty skillNames array may return an empty or trivial result
- Payment failure on the x402 protocol results in a 402 response and no result
- Skill names with unconventional formatting may not match against supplied resume text

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a per-candidate breakdown with each required skill's match status (met, missing, or inferred), years of experience, the data source (explicit field vs inferred), whether a conflict exists, and a plain-language detail explanation. Also returns a list of skills compared, any overlap across candidates, and a set of limitations clarifying that no hiring decision is made and no data is invented.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "candidates": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
     },
     "text": {
      "type": "string",
      "maxLength": 20000,
      "minLength": 1
     },
     "roles": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "title",
        "employer"
       ],
       "properties": {
        "end": {
         "type": "string",
         "maxLength": 20,
         "minLength": 1
        },
        "text": {
         "type": "string",
         "maxLength": 2000,
         "minLength": 1
        },
        "start": {
         "type": "string",
         "maxLength": 20,
         "minLength": 1
        },
        "title": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "employer": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        }
       },
       "additionalProperties": false
      },
      "maxItems": 20
     },
     "skills": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "name": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "years": {
         "type": "number",
         "maximum": 80,
         "minimum": 0
        }
       },
       "additionalProperties": false
      },
      "maxItems": 40
     },
     "qualifications": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "name": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "year": {
         "type": "integer",
         "maximum": 2100,
         "minimum": 1900
        }
       },
       "additionalProperties": false
      },
      "maxItems": 20
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20,
   "minItems": 1
  },
  "skillNames": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 200,
    "minLength": 1
   },
   "maxItems": 40
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "issues": [],
  "status": "compared",
  "overlap": [],
  "checkedAt": "2026-11-03T10:00:00.000Z",
  "candidates": [
   {
    "skills": [
     {
      "name": "TypeScript",
      "years": 4,
      "source": "field",
      "conflict": false,
      "yearsSpecified": true
     },
     {
      "name": "JS",
      "years": 2,
      "source": "field",
      "conflict": false,
      "yearsSpecified": true
     }
    ],
    "matched": [
     {
      "name": "TypeScript",
      "years": 4,
      "detail": "The skill name matches the supplied resume.",
      "status": "met",
      "inferred": false,
      "candidateRef": "ada",
      "yearsSpecified": true
     },
     {
      "name": "JavaScript",
      "years": 0,
      "detail": "The skill was not in the supplied resume. One was not invented.",
      "status": "missing",
      "inferred": false,
      "candidateRef": "ada",
      "yearsSpecified": false
     }
    ],
    "candidateRef": "ada"
   },
   {
    "skills": [
     {
      "name": "Python",
      "years": 6,
      "source": "field",
      "conflict": false,
      "yearsSpecified": true
     }
    ],
    "matched": [
     {
      "name": "TypeScript",
      "years": 0,
      "detail": "The skill was not in the supplied resume. One was not invented.",
      "status": "missing",
      "inferred": false,
      "candidateRef": "grace",
      "yearsSpecified": false
     },
     {
      "name": "JavaScript",
      "years": 0,
      "detail": "The skill was not in the supplied resume. One was not invented.",
      "status": "missing",
      "inferred": false,
      "candidateRef": "grace",
      "yearsSpecified": false
     }
    ],
    "candidateRef": "grace"
   }
  ],
  "skillNames": [
   "TypeScript",
   "JavaScript"
  ],
  "limitations": [
   "No hiring decision is made. A person decides.",
   "Skills, employment history, qualifications, and references are not invented.",
   "Protected personal attributes are ignored and are not used for matching or ranking.",
   "A match is marked inferred only when a caller-supplied alias links two names.",
   "Date gaps are reported from supplied dates and are not ranking penalties."
  ],
  "hiringDecision": false,
  "qualificationsInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-candidate-skill-compare-51f44dd7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
