level-up-character

name	level-up-character
description	Level up an existing Galactic Adventures RPG character, applying advancement benefits per the rules.
argument-hint	[character file] [new level]

Level Up Character Skill

Apply level-up advancement to an existing character sheet using the rules from the character advancement table and the relevant race/class chapters.

Prerequisites

• Read the character's current sheet from characters/.
• Reference the advancement rules in @workspace .github/skills/rules/1-characters (Character Advancement section).
• Reference race details in @workspace .github/skills/rules/2-races for race advancement levels.
• Reference class details in @workspace .github/skills/rules/3-classes for class advancement levels.
• Reference feats in @workspace .github/skills/rules/1-characters (Feats section) if the player chooses a feat instead of a race/class feature.
• Reference psychic abilities in @workspace .github/skills/rules/4-psychic-abilities if the character gains psychic abilities.
• Reference equipment in @workspace .github/skills/rules/5-equipment if new gear is acquired.

Level Advancement Table

Lvl	Exp	Benefit
2	500	Training
3	1,250	Race advancement
4	2,500	Learning
5	4,500	Class advancement
6	7,000	Training
7	10,000	Race advancement
8	13,500	Learning
9	17,500	Class advancement
10	22,000	Training
11	27,000	Race advancement
12	32,750	Learning
13	38,750	Class advancement
14	45,500	Training
15	52,500	Race advancement
16	60,000	Learning
17	68,250	Class advancement
18	77,000	Training
19	87,000	Race advancement
20	100,000	Learning

Benefit Types

• Training: Gain training in 2 stats, 2 expertise, 1 weapon category. Increase available heroic actions per day by 1. Gain health based on background.
• Learning: Gain training in 2 stats, 2 expertise, 1 weapon category. Gain health equal to willpower.
• Race advancement: Gain 1 new race feature or feat, race advancement health bonus (+5 mechanoid/hiveborn/skaalith, +4 human/celestial/voidspawn/android, +3 starborn/typhoran/scurvyn), and other race-specific bonuses.
• Class advancement: Gain 1 new class feature or feat, class advancement health bonus (+5 soldier/warrior, +4 vanguard/operative, +3 sniper/psychic), and other class-specific bonuses.

Steps

1. Read the character file and identify their current level, race, class, background, stats, features, and equipment.
2. Determine the new level and look up the benefit type from the advancement table.
3. Apply the benefit:
   • For Training/Learning: Ask the player (or suggest) which 2 stats, 2 expertise, and 1 weapon category to train. Apply health gains.
   • For Race advancement: Present available race features and feats. Let the player choose one. Apply health bonus and any race-specific bonuses.
   • For Class advancement: Present available class features and feats. Let the player choose one. Apply health bonus and any class-specific bonuses.
4. Update the character sheet with all new stats, features, health, and any new abilities or equipment.
5. Present a summary of all changes made, highlighting new features, stat increases, and health gained.

Output Format

Update the existing character Markdown file in-place. Include a changelog section or annotation at the bottom:

## Level Up: [Old Level] → [New Level]
- **Benefit**: [Training / Learning / Race advancement / Class advancement]
- **Health gained**: +X (now Y total)
- **New training**: [stats, expertise, weapon category]
- **New feature**: [feature name and description, if applicable]
- **Other changes**: [any additional notes]

Use immersive sci-fi flavor when describing new features or abilities gained.