# Glossary Modal Editor

> Efficiently update the Glossary modal UI, hooks, and data so the in-app glossary stays polished, searchable, and accurate for every term. Use when this capability is needed.

- Skill: `tomevault-io/glossary-modal-editor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/glossary-modal-editor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/glossary-modal-editor/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/glossary-modal-editor

---


# Glossary Modal Editor

Use this skill when you need to:

- change the Glossary modal layout, focus behavior, keyboard shortcuts, or resizing logic in `src/components/Glossary/Glossary.tsx` and its sub-components.
- adjust how external UI elements (GameModals, ActionPane buttons, character sheets, tooltips) trigger or navigate within the glossary.
- add, edit, or reorganize glossary content files so the modal renders new information.

## Workflow

1. **Verify the data surface**: Start by handling glossary JSON entries under `public/data/glossary/entries/`, obeying the `id`, `category`, `filePath`, and markdown rules. Reference `references/data-editing.md` for file structure, tooltip markup, table styling, and index-generation reminders before touching the modal.
2. **Update the UI**: Use `references/component-architecture.md` to trace how `Glossary` composes `GlossaryHeader`, `GlossarySidebar`, `GlossaryEntryPanel`, `GlossaryFooter`, and `GlossaryResizeHandles` inside `WindowFrame`, how it uses `useGlossaryModal`, `useGlossarySearch`, and the surrounding `GlossaryContext`, and which higher-level modules (e.g., `GameModals.tsx`, `App.tsx`, tooltips, `SingleGlossaryEntryModal`) rely on it.
3. **Validate end-to-end**: Run `node scripts/generateGlossaryIndex.js`, confirm no duplicate IDs or missing categories, and trigger the glossary in-app (Open the modal, use tooltips, or open a single entry modal) to ensure the new data appears and navigation callbacks still work.

## References

- `references/component-architecture.md`
- `references/data-editing.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/gambitnl) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->

