historical-research

name: historical-research description: Extract historical entities from narrative text. Use when analyzing eras, timelines, calendars, holidays, seasons, alliances, empires, kingdoms, and era transitions.

Domain skill for historical and chronological extraction.

Entity Types

Type	Description
`era`	Historical era, age, or epoch
`era_transition`	Transition between eras
`timeline`	Chronological sequence of events
`calendar`	Calendar or timekeeping system
`holiday`	Holiday or special date
`season`	Named season or time of year
`alliance`	Historical or political alliance
`empire`	Empire or major state entity
`kingdom`	Kingdom or sovereign territory
`nation`	Nation or country

Extraction Rules

Eras: Named periods (Age of Magic, Dark Times) — extract with timeframe
Transitions: What caused era changes (wars, discoveries, cataclysms)
Timelines: Chronological sequence of mentioned events
Calendars: Timekeeping systems, named months, cycles
States: Empires, kingdoms, nations — with their boundaries and rulers

Output Format

Write to entities/society.json (society-team file):

{
  "eras": [
    {
      "id": 1,
      "world_id": 1,
      "name": "Age of Magic",
      "description": "Ancient era when sorcerers ruled the skies",
      "start_date": "1026-01-01T00:00:00+00:00",
      "end_date": "1526-01-01T00:00:00+00:00",
      "parent_era_id": null,
      "child_era_ids": [],
      "major_events": ["Great War"],
      "cultural_notes": "Magic was central to society",
      "technological_level": "Arcane",
      "is_ongoing": false,
      "color_code": "#5b3bff",
      "created_at": "2026-02-14T10:00:00+00:00",
      "updated_at": "2026-02-14T10:00:00+00:00",
      "version": 1
    }
  ],
  "era_transitions": [
    {
      "id": 2,
      "world_id": 1,
      "name": "The Great War Transition",
      "description": "Magic waned after the Great War, ending the Age of Magic",
      "from_era_id": 1,
      "to_era_id": 3,
      "transition_date": "1526-01-01T00:00:00+00:00",
      "transition_type": "catastrophic",
      "trigger_events": ["Great War"],
      "key_figures": [5],
      "social_impact": "Collapse of mage houses",
      "economic_impact": null,
      "political_impact": null,
      "magical_impact": "Mana scarcity",
      "stories_and_legends": ["The Last Spell"],
      "artifacts": [],
      "created_at": "2026-02-14T10:00:00+00:00",
      "updated_at": "2026-02-14T10:00:00+00:00",
      "version": 1
    }
  ],
  "next_id": 3
}

Key Considerations

Relative time: Not all systems use absolute dates (cycles, ages)
Multiple perspectives: History may differ by culture (victors write history)
Cross-references: If needed, track relationships separately in drafts, but final JSON must match LoreData.from_dict.