Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scoutica.com/llms.txt

Use this file to discover all available pages before exploring further.

While a Skill Card represents a Candidate, a Recruiter Card represents an organization, agency, or individual hiring manager looking for talent on the Scoutica protocol. An Employer Identity lives in a .scoutica/ folder (usually in its own dedicated repository or at the root of a company’s .github organization repo) and consists of three core components.

​
recruiter_profile.json

The public identity of the hiring organization. This file establishes who you are and provides your verified domain. 
{
  "scoutica_version": "0.3.0",
  "entity_type": "in-house",
  "organization": {
    "name": "Traylinx",
    "domain": "traylinx.com",
    "verified": true,
    "domain_txt_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  },
  "industries": ["AI Infrastructure", "Open Source"],
  "engagement_types": ["full-time", "contract"],
  "agent_endpoint": "https://api.traylinx.com/scoutica/webhooks",
  "contact": {
    "email": "talent@traylinx.com"
  }
}
Verification: Domain ownership is verified via a DNS TXT record matching the domain_txt_hash. Candidate agents will check this DNS record, and if it is missing, your agent messages will be dropped as impersonation spam.

​
hiring_rules.yaml

Your rules of engagement. This tells Candidate Agents what to expect in your hiring timeline and sets hard limits. If a Candidate’s salary floor exceeds your compensation_band.max_base_eur, their AI agent will auto-reject your role before they even see it.
Example
version: "1.0"
sla:
  max_initial_response_days: 7
  max_total_interview_days: 21
  feedback_guaranteed: true
transparency:
  salary_always_provided: true
limits:
  compensation_band:
    max_base_eur: 180000
  allowed_locations:
    - EU
    - UK
auto_reject:
  requires_visa_sponsorship: true

​
roles/<role_id>.json

A structured job posting. This defines exactly what you are looking for, deterministically mapped to candidate skills.
Example
{
  "scoutica_version": "0.3.0",
  "job_id": "req_104",
  "title": "Senior AI Architect",
  "status": "active",
  "engagement": "full-time",
  "location": {
    "type": "remote",
    "regions": ["EU", "UK"]
  },
  "compensation": {
    "currency": "EUR",
    "base_min": 120000,
    "base_max": 150000,
    "equity_target_percent": 0.5
  },
  "requirements": {
    "years_experience": 5,
    "hard_skills": [
      { "name": "Python", "level": "expert" },
      { "name": "Agentic Architecture", "level": "advanced" }
    ]
  }
}
When you search for candidates and send them an opportunity, your agent attaches the job_id, allowing their agent to fetch this JSON file, compare it against their profile.json, and run a deterministic scoring evaluation.