app-shell

Govern settings, command palette, navigation, panels, modals, favorites, and persistence for a Kubernetes desktop GUI.

411|21|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/luxury-yacht/app --skill app-shell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-shell
Source: https://github.com/luxury-yacht/app/tree/main/.agents/skills/app-shell
Command: npx skills add https://github.com/luxury-yacht/app --skill app-shell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the complexity of maintaining a consistent, user-friendly “control center” in a Kubernetes desktop GUI—covering settings, command palette, navigation, dockable panels, favorites, and the persistence rules that keep the UI feeling stable across sessions.

Core Features & Use Cases

  • Unified UX contracts for app shell areas: Provides shared contracts for settings metadata flow, command palette integration, keyboard/shortcut focus behavior, modal accessibility, and dockable panel/tab identity.
  • Persistence and state correctness: Defines how persisted app preferences hydrate from backend schema metadata and how layout/panel defaults are normalized and stored.
  • Operational guidance for UI teams: Ensures settings UI doesn’t duplicate backend constants, uses the typed helpers in core/settings, and applies UpdateAppPreferences semantics with rollback on failure.
  • Visual and interaction safety: Emphasizes focus trapping, drag/drop selection behavior, and deterministic tests for visual shell behavior.

Quick Start

Use the app-shell skill to update the command palette and dockable panel behavior by following the listed core contracts and checklist for persistence, focus, shortcuts, and visual shell tests.

Frequently Asked Questions about app-shell

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist dockable panel layouts and user preferences in a Kubernetes desktop GUI?

Persist dockable panel layouts by hydrating normalized state from backend schema metadata and applying the UpdateAppPreferences mutation with optimistic update and rollback on failure.

How does focus management work for modals and keyboard shortcuts in a desktop app shell?

Focus management in the app shell enforces focus trapping within modals, governs keyboard shortcut behavior, and maintains deterministic selection rules during drag-and-drop panel interactions.

What's the best way to integrate a command palette into a Kubernetes UI navigation system?

Integrate a command palette by following the app shell's shared UX contracts, ensuring strict alignment of labels, icons, and categories across all navigation surfaces.

Do I need backend-owned settings schemas to manage app shell preferences?

Yes, app shell preferences require backend-owned settings schemas accessed via core/settings typed helpers to prevent duplicating backend constants and ensure correct state hydration.

Why are my persisted app preferences rolling back after a UI update fails?

Preferences roll back because the UpdateAppPreferences mutation enforces optimistic update semantics, reverting local state changes if the backend fails to confirm the preference update.

Can I run deterministic tests for visual shell behavior without a live backend?

Yes, the app shell requires deterministic execution for visual tests by normalizing layout and panel defaults from backend metadata, allowing consistent UI behavior verification without live connections.