Agent skill · supabase
studio-shortcuts
Keyboard shortcut conventions for Supabase Studio. Use when adding a
What it needs
About 2k tokens when loaded.
What this skill does
Studio Keyboard Shortcuts When Studio UI changes introduce or materially alter repeated user actions, consider whether keyboard shortcut coverage should be added or updated. Shortcuts use the shared Studio shortcut system and must be discoverable from the visible UI. Rules Never add a one-off keydown listener for a normal Studio action — register it through the shortcut registry and useShortcut. Every registered shortcut is exposed where the action is visible, via ShortcutTooltip, ShortcutBadge, or a command-menu badge. G then … chords are reserved for navigation. Avoid broad Mod+letter shortcuts that overlap common browser, editor, system, copy/save/search, or devtools behavior. Before adding a shortcut, check the registry and any remaining non-registry listeners for collisions. Every search/filter <Input> gets onKeyDown={onSearchInputEscape(...)} — see Search inputs. Preferred pattern Add definitions in apps/studio/state/shortcuts/registry.ts or apps/studio/state/shortcuts/registry/. Register with useShortcut. Gate availability with enabled. Surface visible actions with ShortcutTooltip or ShortcutBadge. Prefer scoped, mnemonic sequential chords over global modifier chords. Set showInSettings: false on contextual shortcuts (scoped to a specific page state, sheet, or panel). When a shortcut group should appear in the reference sheet (Shift+?), add the group key to SHORTCUTREFERENCEGROUPORDER in apps/studio/state/shortcuts/referenceGroups.ts and a human label to GROUPLABELS in ShortcutsReferenceSheet.tsx. For sheet-scoped shortcuts (active only while a <Sheet> is open), mount useShortcut inside the sheet component gated by the open prop ({ enabled: open }) — apps/studio/components/interfaces/Platform/Webhooks/PlatformWebhooksDeliveryDetailsSheet.tsx is the canonical example. A shortcut that opens a sheet from anywhere is global instead, gated by whatever makes the action valid (e.g. useConnectSheetShortcut checks project health). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills supabase/studio-shortcuts