# sknpack - Oghma Knowledge Packs for SkyrimNet

SkyrimNet Knowledge Packs (`.sknpack`) generated from CHIM's Oghma Infinium lore.
Drop-in importable via the SkyrimNet beta Web UI (Knowledge Packs → Import).

## What's here

20 packs, ~5,000 Tamrielic lore entries, ~3.2 MB total.

| Pack family | Files | Scope | Entry `type` |
|---|---|---|---|
| Content | `Oghma_-_{Figures_Gods,Artifacts,Armor_Weapons,Items,Groups_Books,Creatures,Dynamic}.sknpack` | Everyone | KNOWLEDGE |
| Spells | `Oghma_-_Spells.sknpack` | Everyone | SKILL |
| Locations | `Oghma_-_Locations_-_{Whiterun,Rift,Solstheim,Reach,Eastmarch,Falkreath,Haafingar,Pale,Winterhold,Hjaalmarch,Other}.sknpack` | `location` field set to hold name | LOCATION |
| Visual | `Oghma_-_Visual_Descriptions.sknpack` | Everyone, for Omnisight perception | KNOWLEDGE |

Each entry carries an `importance` score: `0.75` for the deeper lore variant (scholars), `0.40` for the common-knowledge variant (commoners), `0.50` for visual descriptions. Same topic often appears twice at different depths - SkyrimNet's ranking picks the right one for the NPC.

## Pipeline

```
CHIM Oghma Infinium Google Sheet
    │  oghma-ingest
    ▼
ChromaDB @ iris-dev.eachpath.local:35000
   (oghma_lore | oghma_basic | oghma_visual)
    │  oghma-export-packs
    ▼
/home/dafit/nimmerverse/nimmersky/sknpack/*.sknpack
    │  SkyrimNet UI → Import
    ▼
In-game NPC knowledge
```

## Regenerate

```bash
cd /home/dafit/nimmerverse/nimmersky/oghma-proxy
python3 -m oghma_proxy.export_packs
```

Overwrites everything in this directory. Also available as `oghma-export-packs` once the package is installed (`pip install -e .`).

Options: `--host`, `--port`, `--output-dir`, `--dry-run`.

## Format

SkyrimNet beta `format_version: 1`. See exporter source for the full envelope:
`oghma-proxy/src/oghma_proxy/export_packs.py`.

## Phase 2 (not yet shipped)

The `tags: []` and `condition_expr: ""` fields are intentionally empty - Phase 1 exports the raw knowledge with safe defaults. Phase 2 will use a teacher model on theia to enrich each entry with tags (spell-school, armor-class, faction-affinity) and conditional expressions (quest-gated visibility). Phase 2 will bump pack `version` from `1.0.0` → `1.1.0`.

---

**Version:** 1.0 | **Created:** 2026-04-13 | **Updated:** 2026-04-13
