pwa-troubleshooting

Diagnose and fix PWA issues with service workers, caching, offline functionality, and storage.

Updated Nov 20, 2025
One-click install
npx skills add https://github.com/skaihigh/claude-agent-command-templates --skill pwa-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pwa-troubleshooting
Source: https://github.com/skaihigh/claude-agent-command-templates/tree/main/templates/react-pwa/.claude/specialized/skills/pwa-troubleshooting
Command: npx skills add https://github.com/skaihigh/claude-agent-command-templates --skill pwa-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes common PWA issues that prevent service workers from registering, caching from working, and offline functionality from performing reliably, including storage-related problems in web apps.

Core Features & Use Cases

  • Service Worker debugging: Validate registration, activation, and updates across browsers.
  • Caching & Offline: Ensure assets are cached properly and offline mode works.
  • Storage & Persistence: Check IndexedDB, Cache API, and storage quotas.
  • Use Case: When a PWA fails to install or remains offline, run these checks to restore reliability.

Quick Start

Run the guided checks in your app to verify service worker registration, caching health, offline readiness, and storage usage.

Frequently Asked Questions about pwa-troubleshooting

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

FAQPage Schema
Why does my PWA service worker fail to register or update across different browsers?

PWA service worker registration fails when validation checks for activation and updates are skipped. Guided diagnostics verify registration health across browsers and provide actionable code patterns to restore reliable updates.

How do I fix PWA caching issues that break offline functionality?

Fix PWA caching issues by running guided checks to ensure assets are cached properly. These checks diagnose offline readiness, verify storage persistence, and confirm the offline mode performs reliably without losing cached data.

What is the best way to diagnose IndexedDB and Cache API storage quota problems in a web app?

Diagnose IndexedDB and Cache API storage quota problems using non-destructive safety checks. This process inspects local storage usage, verifies storage persistence, and identifies quota limits affecting your web application's data retention.

Does PWA troubleshooting provide non-destructive verification steps for local storage?

PWA troubleshooting provides non-destructive verification steps for local storage. It applies safety checks to diagnose IndexedDB and Cache API issues, ensuring guidance restores offline functionality without deleting existing cached assets or stored data.

Can I use PWA troubleshooting checks when my PWA fails to install?

You can use PWA troubleshooting checks when a PWA fails to install. The guided checks verify service worker registration, caching health, offline readiness, and storage usage to quickly restore installation reliability.