divemap

Guidelines and patterns for implementing high-quality, "mobile-first" responsive user interfaces in the Divemap project using Tailwind CSS. Use this skill when designing or refactoring components and pages to ensure they are visually striking, functional, and touch-optimized on all devices.

Assists with Alembic database migrations in Python projects. Use when generating, applying, or debugging database schema migrations to ensure consistency and prevent conflicts.

Workflow for building, testing, and publishing new Android app versions (PWA/TWA) using Bubblewrap to the Google Play Store. Use this when the user wants to build a new APK/AAB or release an update to Android.

Mandatory standard operating procedure for running tests in the Divemap backend. Explicitly forbids direct pytest commands that cause data loss and explains SQLite incompatibility.

Guidelines and workflows for detecting and fixing Cross-Site Scripting (XSS) vulnerabilities in frontend code. Use this skill when auditing frontend components, reviewing PRs with user-generated content, or investigating reported XSS issues.

Standard procedure for testing authenticated FastAPI endpoints via curl in the CLI. Use this when verifying backend logic without a frontend, or when debugging authentication/permission issues.

Guidelines and automated scripts for managing, naming, and safely cleaning up Git branches (both local and remote) in the divemap project. Use when asked to manage branches, clean up merged branches, or understand branch conventions.

Diagnoses and fixes routing conflicts between the Frontend PWA Service Worker and Backend/Nginx endpoints in the Divemap project. Also handles Workbox and Manifest loading errors. Use when a URL works via curl but fails in the browser, or when seeing Manifest Syntax Errors.

Specialized testing workflow for AI/LLM-driven features. Use when verifying that natural language inputs map to correct structured intents and downstream logic, or when creating regression tests for prompts.

Architecture and best practices for implementing an LLM-backed RAG/Chat system with FastAPI and SQLAlchemy. Use when building or refactoring chatbots that need to query a local database based on natural language intent.

Standard operating procedure for fixing React deprecation warnings. Use when encountering console warnings about future React API changes or deprecated features, such as defaultProps on functional components.

Guide for using Serena effectively. Use when performing complex coding tasks, understanding codebase architecture, or needing semantic code navigation and editing capabilities.

Standard patterns and utility classes for fixing flexbox layout issues on mobile views. Use when UI elements (buttons, icons, avatars) extend beyond the screen, get squished, or text overflows incorrectly on narrow viewports.

Standard patterns for the Admin Dashboard in Divemap, covering layout standards (wide containers) and data table implementations (TanStack vs. Ant Design). Use when creating or refactoring admin pages to ensure visual consistency.

Standards and UX principles for modifying the desktop and mobile navigation bars. Use when asked to add, remove, or rearrange items in the header, or when tasked with saving horizontal space in the UI.