Documentation index
Documentation
ConceptsSHIPPED

XP progression and skill metrics

Measure agent and skill performance through ledger-correlated progression events.

Level curve

Karnelian uses a 99-level exponential progression curve. The documented threshold grows from a 100 XP base using `1.172^(N-1)`, so later levels require progressively more verified work.

XP sources

Awards can reflect completed tasks, action risk, output quality, Elixir contribution, and skill results. XP events correlate with ledger evidence so progression is inspectable rather than an opaque score.

Skill metrics

  • Track executions, successes, failures, and quality
  • Compare top skills through derived performance data
  • Use repeated successful outcomes as an Elixir draft signal
  • Display milestones and level changes in the desktop workspace

Progression API

GET/v1/xp/agents/{id}

Read an agent's current progression

GET/v1/xp/agents/{id}/history

Review XP event history

GET/v1/xp/leaderboard

List ranked agents

GET/v1/xp/skills/top

Compare top-performing skills

POST/v1/xp/award

Record an explicit XP award