json-formatter

Base skill for JSON output formatting. All extraction skills produce JSON that can be loaded by the Lore GUI (LoreData.from_dict).

Rules

1. Valid JSON: Output must be parseable JSON — no trailing commas, no comments.
2. Export schema: Use the GUI export format defined in src/presentation/gui/lore_data.py.
3. Plural collections: Each entity collection is a top-level key with a plural name and an array value (e.g., worlds, characters, locations).
4. IDs are consistent: Use integer IDs for GUI export collections. For entity types that use UUIDs in the domain model, use UUID strings consistently across references.
5. Field names: Use exact domain field names (snake_case). Do not invent type or entity_type unless that field exists in the domain model.
6. Dates: Use ISO 8601 strings for timestamps (created_at, updated_at, start_date, end_date).

Output Structure (Export-Compatible)

json
1{
2  "worlds": [],
3  "characters": [],
4  "locations": [],
5  "quests": [],
6  "items": [],
7  "events": [],
8  "stories": [],
9  "storylines": [],
10  "tags": [],
11  "images": [],
12  "choices": [],
13  "flowcharts": [],
14  "handouts": [],
15  "inspirations": [],
16  "environments": [],
17  "banners": [],
18  "character_relationships": [],
19  "factions": [],
20  "shops": [],
21  "maps": [],
22  "notes": [],
23  "requirements": [],
24  "sessions": [],
25  "tokenboards": [],
26  "pity": [],
27  "pulls": [],
28  "player_profiles": [],
29  "currencies": [],
30  "rewards": [],
31  "purchases": [],
32  "event_chains": [],
33  "faction_memberships": [],
34  "lore_axioms": [],
35  "music_controls": [],
36  "music_states": [],
37  "music_themes": [],
38  "music_tracks": [],
39  "progression_events": [],
40  "character_states": [],
41  "textures": [],
42  "models": [],
43  "next_id": 1
44}

Required Fields (Core Entities)

Use these minimum fields so JSON loads without validation errors:

• worlds: id, name, description, created_at, updated_at, version
• characters: id, world_id, name, backstory, status, abilities, created_at, updated_at, version
• locations: id, world_id, name, description, location_type, created_at, updated_at, version
• quests: id, world_id, name, description, objectives, status, participant_ids, reward_ids, created_at, updated_at, version

If a field is unknown, set it to null or an empty list (for arrays), but keep the key.