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}/historyReview XP event history
GET
/v1/xp/leaderboardList ranked agents
GET
/v1/xp/skills/topCompare top-performing skills
POST
/v1/xp/awardRecord an explicit XP award
