started tables reference page

src/personal_mcp/docs/skills/nicegui/SKILL.md

@@ -11,6 +11,7 @@ Use this skill as a progressive reference for NiceGUI applications built with Fa
 
 - Planning or reviewing NiceGUI application structure and FastAPI composition.
 - Building or refactoring pages, components, layouts, and static assets.
+- Creating editable tables with Python-authoritative state, validation, and persistence.
 - Modeling UI state with bindings or bindable dataclasses.
 - Implementing forms, uploads, refreshes, live updates, or background work.
 - Diagnosing UI state, concurrency, navigation, or asset problems.
@@ -71,6 +72,16 @@ Load [component mechanics and customization](./references/component-mechanics-an
 - `ui.select` and `ui.icon` mechanics and caveats
 - dialog scaling when detached popup geometry must be preserved
 
+### Editable Tables
+
+Load [editable tables](./references/tables.md) for:
+
+- Python-authoritative editable `ui.table` state
+- stable row identity across sorting, filtering, and pagination
+- NiceGUI editors in Quasar `body-cell-*` scoped slots
+- validation, persistence, rejection, and canonical row refresh
+- the full `body` slot required when escalating to `QPopupEdit`
+
 ### Bindable State
 
 Load [bindable dataclasses](./references/binding-dataclasses.md) for:
@@ -118,7 +129,8 @@ Load [source documentation](./references/source-documentation.md) when:
 1. Load [application architecture](./references/architecture.md) for page and component ownership decisions.
 2. Load [styling and customization](./references/styling-and-customization.md) for themes, layout, responsive presentation, utility classes, or CSS.
 3. Load [component mechanics and customization](./references/component-mechanics-and-customization.md) when behavior must be mapped across NiceGUI, Quasar, and Vue, or when detached content and component-specific behavior are involved.
-4. Add [interaction patterns](./references/interaction-patterns.md) or [bindable dataclasses](./references/binding-dataclasses.md) according to the page behavior.
+4. Load [editable tables](./references/tables.md) when table cells accept user changes or `QPopupEdit` is being considered.
+5. Add [interaction patterns](./references/interaction-patterns.md) or [bindable dataclasses](./references/binding-dataclasses.md) according to the page behavior.
 
 ### Debugging Or Production Review
 
@@ -133,6 +145,7 @@ Load [source documentation](./references/source-documentation.md) when:
 - Avoid blocking I/O and CPU-heavy work in the UI event loop.
 - Prefer event-driven updates and explicit refreshes over unrelated polling.
 - Discover component capabilities through NiceGUI docs and constructors, then the wrapped Quasar API.
+- Keep editable table records authoritative in Python; send stable row keys with edit proposals and reassert canonical rows after validation.
 - Research the current NiceGUI and Quasar source documentation before generating component-specific code or CSS.
 - Prefer constructor arguments and native Quasar features through NiceGUI; use Tailwind for structure and scoped static CSS for stable fine tuning.
 - Provide loading, success, and failure states for user-triggered work.