pwa-troubleshooting

Diagnose PWA service worker, caching, offline, storage, and install issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides step‑by‑step guidance to debug common Progressive Web App problems such as service‑worker registration failures, caching glitches, offline errors, storage limits, and install prompts.

Core Features & Use Cases

  • Service Worker diagnostics: checks registration, activation, and updates.
  • Cache inspection and clearing: lists caches, verifies content, and removes stale data.
  • Offline testing: simulates offline mode and monitors events.
  • Storage monitoring: evaluates quota usage and IndexedDB health.
  • Install prompt troubleshooting: validates manifest and beforeinstallprompt handling.

Quick Start

Ask the skill to troubleshoot your PWA by describing the specific issue you encounter.

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 and activate?

PWA service worker registration fails often stem from invalid file paths or scope mismatches. This skill inspects registration APIs, activation events, and update cycles via the browser developer console to identify failures and provide corrective code snippets.

How do I clear stale cache data in a Progressive Web App?

To clear stale cache data in a Progressive Web App, you must inspect the Cache API storage. This skill lists existing caches, verifies stored content, and executes targeted removal of outdated assets to resolve caching glitches.

How can I test offline functionality and monitor events in my PWA?

Testing PWA offline functionality requires simulating offline mode and monitoring service worker events. This skill guides you through offline network simulation and event tracking to ensure your app loads correctly without connectivity.

What is the best way to troubleshoot PWA install prompt issues?

Troubleshooting PWA install prompt issues involves validating your manifest file and checking beforeinstallprompt event handling. This skill verifies manifest configurations and install prompt logic to resolve installation delays.

How do I monitor IndexedDB health and browser storage quota limits?

Monitoring IndexedDB health and storage quota limits involves checking the browser's storage estimation interfaces. This skill evaluates quota usage and database integrity to prevent storage limit errors in your web project.