diff --git a/.claude/skills/orient/SKILL.md b/.claude/skills/orient/SKILL.md
new file mode 100644
index 0000000..470beff
--- /dev/null
+++ b/.claude/skills/orient/SKILL.md
@@ -0,0 +1,46 @@
+---
+name: orient
+description: >
+  Quick project orientation for new context. Performs a minimal scan of CLAUDE.md,
+  skill frontmatters, and mod directory structure to bootstrap understanding
+  without flooding context. Use at the start of a new conversation, when
+  spawning subagents, or when context has been lost. Triggers on: "orient",
+  "scan project", "get up to speed", "what is this project", "bootstrap context".
+user-invocable: true
+allowed-tools: Read, Grep, Glob, Bash
+---
+
+# Orient
+
+Minimal context bootstrap. Read **only** what's listed below — nothing more.
+
+## Step 1: Project overview
+
+Read `README.md` in the project root. This gives project structure, core
+systems, and pointers to detailed references. Do NOT read `CLAUDE.md` yet —
+it contains detailed conventions only needed when writing code.
+
+## Step 2: Available skills
+
+Glob for `.claude/skills/*/SKILL.md`. For each, read only the YAML frontmatter
+(the block between `---` fences, typically lines 1–10). Do NOT read skill
+bodies — the frontmatter descriptions are enough to know when to invoke them.
+
+## Step 3: Mod file structure
+
+Glob for `lords_of_ash/**/*` with depth 2 (e.g. `lords_of_ash/*` and
+`lords_of_ash/*/*`) to see what directories and files exist on disk. Do NOT
+read any file contents.
+
+## Step 4: Recent activity
+
+Run `git log --oneline -5` to see what was last worked on.
+
+## Output
+
+Summarize in 5–8 lines:
+- What the project is (one sentence)
+- Skills available (names only)
+- Directories/files present in the mod
+- What was last worked on (from git log)
+- Any gaps between CLAUDE.md and actual file structure
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f1592d4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Lords of Ash
+
+A Crusader Kings III total conversion mod set in Brandon Sanderson's Mistborn
+universe during the Final Empire era. CK3 version 1.18.*.
+
+## Structure
+
+```
+lords_of_ash/              # CK3 mod directory
+  common/                  # Game data: traits, cultures, religions, decisions, etc.
+  events/                  # Event chains (snapping, balls, Lord Ruler, hemalurgy, etc.)
+  history/                 # Starting characters, provinces, title holders
+  localization/english/    # All display strings (l_english.yml)
+lords-of-ash.mod           # Outer mod descriptor
+docs/
+  lore/                    # Mistborn universe reference (metallic arts, factions, setting)
+  bookmarks/               # Story arc planning
+  ck3-modding/             # CK3 modding reference
+.claude/skills/            # Claude Code skills (commit, orient, ck3-game-install, etc.)
+CLAUDE.md                  # Full conventions, naming rules, and system details
+```
+
+## Core Systems
+
+- **Allomancy** — Genetic trait system. Dormant potential activates via "snapping" into Misting types or full Mistborn.
+- **Lord Ruler Attention** — Variable (0–100) tracking defiance; escalating consequences.
+- **Compounding** — Allomantic + Feruchemical overlap triggers on yearly pulse.
+- **Hemalurgy** — Spike-based power transfer system.
+
+## Key References
+
+| What | Where |
+|------|-------|
+| Modding conventions | `CLAUDE.md` |
+| Lore reference | `docs/lore/mistborn-universe.md` |
+| Known issues | `lords_of_ash/REVIEW_NOTES.txt` |
+| Game install / logs | `/orient` or `/ck3-game-install` skills |