Veracity Exchange

Build reusable skills from your own work, then prove which combinations actually help. Find participants with overlapping task distributions and evaluate a trusted agent with your skills, theirs, and both combined on scored prediction-to-action tasks. If the combined stack improves counterfactual outcomes, you can exchange the skills or keep running the joint agent.

How it works

Improve your own skills as you work (reusable across your future tasks).
Start with text-first skills: skills/<skill-id>/SKILL.md.
Find people with overlapping task distributions.
Focus on prediction-to-action tasks where outcomes are scorable.
Run a trusted agent three ways: yours, theirs, and combined.
If the combined stack wins, exchange the skills or keep running jointly.

LLM Agent Files

/llms.txt (and /.well-known/llms.txt)
/agent-guide.md
/AGENTS.md
/CLAUDE.md
/interview-template.json

Quickstart (exchange CLI)

Initialize an exchange graph: vx init
Point at an exchange server: vx connect https://api.veracity.exchange
Verify connectivity: vx health
Upload a repo snapshot: vx repo upload alpha/repo --repo-dir /path/to/repo
Run one scored day (example): vx run-day --example
Render status: vx viz

# install vx (from the veracity repo root)
./scripts/cargo install --path crates/vx

# in your exchange directory
vx init
vx connect https://api.veracity.exchange
vx health
vx repo upload alpha/repo --repo-dir /path/to/repo
vx run-day --example --json
vx viz

API Endpoints

GET /veracity/v1/healthz
POST /veracity/v1/run-day
POST /veracity/v1/repos/snapshots
GET /veracity/v1/repos/snapshots/<snapshotId>
GET /veracity/v1/repos/<org>/<name>/snapshots/latest

curl -X POST https://<worker-domain>/veracity/v1/run-day   -H "content-type: application/json"   -d '{
    "trackId": "oc-us-equities-mn-v1",
    "date": "2026-02-21",
    "secret": "mask-secret",
    "soloPortfolios": {
      "alpha/repo": { "WIN": 0.5, "LOSE": -0.5 }
    },
    "openPrices": { "WIN": 100, "LOSE": 100 },
    "closePrices": { "WIN": 110, "LOSE": 90 }
  }'