> For the complete documentation index, see [llms.txt](https://stellarskills.gitbook.io/stellarskills-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stellarskills.gitbook.io/stellarskills-docs/operations/commands.md).

# commands

The roots `/skills`, `/skilltree`, and `/stellarskills` are aliases. Examples use `/skills`. `<required>` arguments must be supplied; `[optional]` arguments may be omitted. Replace IDs and player names with real values.

All roots require the menu permission. Administrative branches require admin permission **and** the relevant sub-permission. Player-target arguments resolve an online player, not an arbitrary offline name/UUID. Most GUI commands must be run by a player.

## Player commands

| Command                                     | Purpose                                                              |
| ------------------------------------------- | -------------------------------------------------------------------- |
| `/skills`                                   | Classes when required; otherwise an accessible skills tree           |
| `/skills tree <tree>`                       | Request a specific permitted tree                                    |
| `/skills classes`                           | Class menu                                                           |
| `/skills class`                             | Class-menu alias                                                     |
| `/skills class select <class>`              | Select an available class under server rules                         |
| `/skills class remove <class>`              | Player removal when policy permits                                   |
| `/skills allocate <tree> <node>`            | Buy/upgrade a node; choices may need confirmation                    |
| `/skills choose <tree> <node> <option_ids>` | Exact comma-separated choice IDs, no spaces                          |
| `/skills refund <tree> <node>`              | Refund one eligible rank                                             |
| `/skills points`                            | Current skill currency balances                                      |
| `/skills level`                             | Trainer level and XP summary                                         |
| `/skills effects`                           | Registered-effect summary, not an exhaustive guarantee of live hooks |
| `/skills quests`                            | Quest journal/text overview                                          |
| `/skills quests start <quest>`              | Explicitly accept an available quest/branch                          |
| `/skills objectives`                        | Quest overview alias                                                 |
| `/skills goals`                             | Quest overview alias                                                 |
| `/skills journey`                           | Journey hub                                                          |
| `/skills features`                          | Journey alias                                                        |
| `/skills leaderboards`                      | Dedicated rankings screen                                            |
| `/skills rankings`                          | Rankings alias                                                       |

There is no generic `/skills quest complete` command that bypasses event progress. Use the correct event or explicit admin recovery tools.

## Content operations

| Command                                   | Sub-permission | Purpose                                       |
| ----------------------------------------- | -------------- | --------------------------------------------- |
| `/skills admin validate`                  | `admin.reload` | Parse/validate disk content                   |
| `/skills admin reload`                    | `admin.reload` | Stage and activate valid content              |
| `/skills admin status`                    | Root `admin`   | Current snapshot summary                      |
| `/skills admin editor <tree>`             | `admin.edit`   | Authorized tree editor                        |
| `/skills admin progression-editor`        | `admin.edit`   | Authorized levels/tasks/quest editor          |
| `/skills admin backup list`               | `admin.backup` | Supported revision names                      |
| `/skills admin backup restore <revision>` | `admin.backup` | Restore a supported revision after validation |

GUI Publish additionally requires `admin.publish`. `backup list/restore` are not a full world/database backup tool and do not provide a generic create command for every file.

## Economy and progression

| Command                                                    | Sub-permission  |
| ---------------------------------------------------------- | --------------- |
| `/skills admin give <player> <currency> <amount> [reason]` | `admin.balance` |
| `/skills admin take <player> <currency> <amount> [reason]` | `admin.balance` |
| `/skills admin set <player> <currency> <amount> [reason]`  | `admin.balance` |
| `/skills admin xp give <player> <amount> [reason]`         | `admin.level`   |
| `/skills admin xp take <player> <amount> [reason]`         | `admin.level`   |
| `/skills admin xp set <player> <amount> [reason]`          | `admin.level`   |
| `/skills admin level set <player> <level> [reason]`        | `admin.level`   |

Amounts are nonnegative whole numbers; `give`/`take` chooses direction. `set` replaces the relevant amount. Administrative level set is clamped to configured starting/maximum level. Historical level points are not repaid merely by lowering and raising XP. These commands are not a quest reset or class reset.

## Resets and feature support

| Command                                                             | Purpose                                                  |
| ------------------------------------------------------------------- | -------------------------------------------------------- |
| `/skills admin reset <player> <tree>`                               | Clear purchased ranks/choices and refund persisted spend |
| `/skills admin reset <player> <tree> refund [reason]`               | Explicit refunding reset                                 |
| `/skills admin reset <player> <tree> keep-points [reason]`          | Clear tree without refunding spend                       |
| `/skills admin objective reset <player> <objective>`                | Reset that quest progress/acceptance/history             |
| `/skills admin objective reset <player> all`                        | Reset all quests for that player                         |
| `/skills admin feature status <player>`                             | Journey summary                                          |
| `/skills admin feature reset <player> <module> <entry>`             | Reset selected Journey state                             |
| `/skills admin feature progress <player> <module> <entry> <amount>` | Add supported feature progress, up to 1 billion units    |

These require `admin.reset`. Read reward/history implications before resetting repeatable content. Objective reset does not deduct XP/points previously awarded. `all` is a special literal, so do not name a quest `all`.

## Class and Hero support

```
/skills admin class status <player>
/skills admin class add <player> <class>
/skills admin class remove <player> <class>
/skills admin class reset <player>
/skills admin class hero status <player>
/skills admin class hero grant <player> <class>
/skills admin class hero revoke <player> <class>
```

These require `admin.class`. Hero revoke clears its fate/forfeit/selection to support deliberate reroll testing; ordinary class reset does not do that. Granting Hero eligibility is not automatically selecting the class.

## Diagnostics

| Command                                               | Purpose                                                                   |
| ----------------------------------------------------- | ------------------------------------------------------------------------- |
| `/skills admin trace <player> <tree> <effect> [base]` | Trace a tree's numeric evaluation, default base 0; requires `admin.trace` |
| `/skills admin audit <player>`                        | Recent sensitive mutations; requires `admin.audit`                        |

Trace is not proof that a real gameplay hook calls the key, nor a complete combined-tree combat simulation. Supply a meaningful base, and remember context filters may exclude contributions in a simple command trace.

Registered permissions include `admin.migrate`, but no complete generic migration command is exposed by this command tree. Do not invent command syntax from the permission name.