> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebulaengage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Earning XP and Credits in Nebula

> Understand how XP and Credits work in Nebula — how you earn them, how they connect to your skill growth, and what makes them different from each other.

Nebula uses two distinct progression currencies: XP (Experience Points) and Credits. Both accumulate as you work through sessions, but they serve different purposes. XP is directly tied to your skill development and tracks how your professional abilities grow over time. Credits are a platform currency separate from your skill scores. Understanding the difference helps you make the most of your progression across sessions.

<Note>
  **XP and Credits are not the same thing.** XP is skill-linked — every XP gain is tied to a specific skill category (or to your overall progression) and directly contributes to leveling up your professional skills. Credits are a platform currency used for Nebula features and are not connected to skill levels or session performance scoring.
</Note>

## How you earn XP

XP is earned throughout a session whenever you take meaningful action. The three main sources are:

* **Making decisions** — each decision checkpoint you complete awards XP based on the quality of your choice and the skill categories the decision tests.
* **Completing objectives** — finishing scenario objectives contributes XP toward your overall progression.
* **Interacting with personas** — engaging with AI-driven colleagues, managers, and stakeholders in ways that demonstrate professional skill generates XP in the relevant categories.

Every XP gain is recorded as an `XPGain` event with the following details:

| Field           | What it tells you                                                                              |
| --------------- | ---------------------------------------------------------------------------------------------- |
| `source`        | Where in the session the XP came from (e.g., a specific decision or interaction)               |
| `amount`        | How many XP points were awarded                                                                |
| `skillCategory` | Which of the six skill categories the XP applies to, or `null` if it contributes to overall XP |
| `reason`        | A description of why the XP was awarded                                                        |
| `earnedAt`      | When the XP was earned during the session                                                      |

## How XP maps to skills

Each XP gain is assigned to one of the six skill categories or recorded as general XP. When XP is tied to a specific skill category — such as `communication` or `decision_making` — it counts toward that skill's level progression.

Your `Progression` object tracks two XP totals:

* **`totalXp`** — the cumulative XP you have earned across all sessions, across all skill categories combined.
* **`xpToNext`** (per skill) — the amount of XP remaining before your level increases in that specific skill category. This value decreases as you earn XP in the relevant category.

Your progression object is updated at the end of every session and persists across your entire history on the platform. XP never resets.

## How you earn Credits

Credits are separate from XP and are awarded through platform activity. Unlike XP, Credits are not tied to individual skill categories or decision quality. Your current Credit balance is visible in your `Progression` object alongside your XP totals and skill scores.

## Tracking your XP over time

Because your `Progression` object persists across all sessions, your XP accumulates continuously. Each session you complete adds to your `totalXp` and moves each affected skill's `xpToNext` closer to zero. When `xpToNext` for a skill reaches zero, your skill level increases and a new `xpToNext` threshold is set.

You can review your full progression — including current XP, Credits, and skill levels — in your dashboard or in the `progression` field of any completed session report.

<AccordionGroup>
  <Accordion title="Does XP carry over if I abandon a session?">
    XP is recorded at the point it is earned, but progression updates are applied when a session completes. If you abandon a session before it reaches `completed` status, XP gains from that session may not be applied to your persistent progression record.
  </Accordion>

  <Accordion title="Can a single action earn XP in more than one skill category?">
    Each `XPGain` record is tied to one skill category (or no category, for general XP). However, a single decision checkpoint can trigger multiple `XPGain` records, each assigned to a different skill category. So one decision can advance your progress in several skills at once.
  </Accordion>

  <Accordion title="Where can I see my full XP history?">
    Your current totals are shown in the dashboard. For a detailed breakdown of XP earned in a specific session — including each individual gain, its source, and the skill it applied to — review the `progression` section of your session report after the session completes.
  </Accordion>
</AccordionGroup>