К основному содержанию
скилл CX Codex

service-worker — скилл для Claude Code: что делает и как установить

Скилл service-worker для Claude Code собирает правила настройки сервис-воркеров, Workbox v7.4, офлайн-кеширования, фоновой синхронизации и push-уведомлений.

MIT 121 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill service-worker -a claude-code
Открыть на GitHub

Что делает service-worker

Скилл передаёт агенту архитектурные правила для работы с жизненным циклом сервис-воркера и библиотеками Workbox v7.4. Он описывает настройку предварительного кеширования оболочки приложения (workbox-precaching), управление устареванием данных через workbox-expiration и подбор стратегий: CacheFirst для картинок со шрифтами, NetworkFirst для динамических данных и StaleWhileRevalidate для баланса скорости и свежести.

Внутри собраны шаблоны для Push API с ключами VAPID, Static Routing API для Chrome 123+ и обработка обновлений через библиотеку workbox-window. Background Sync не поддерживается браузерами Safari и Firefox, поэтому для очереди запросов обязателен запасной сценарий на базе события navigator.onLine.

Какие задачи решает

  • настроить кеширование статики и ответов API через Workbox v7.4
  • организовать офлайн-режим с показом запасной страницы offline.html
  • сохранять запросы в очередь через workbox-background-sync
  • подключить Push API с серверной отправкой по VAPID-ключам

Примеры запросов агенту

  • Настрой сервис-воркер на Workbox: кешируй шрифты и картинки через CacheFirst, а API через NetworkFirst
  • Добавь очередь отправки форм на базе Background Sync с проверкой navigator.onLine для Safari
  • Сконфигурируй предварительное кеширование app shell и отдачу offline.html при сбоях сети

Как установить service-worker

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill service-worker -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-worker/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-worker/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-worker

Как установить service-worker в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill service-worker -a claude-code в терминале проекта.

Что делает скилл service-worker?

Он помогает ИИ-агенту писать код сервис-воркеров: выбирать стратегии Workbox v7.4, организовывать app shell, настраивать уведомления и избегать ошибок кеширования.

Работает ли фоновая синхронизация во всех браузерах?

Background Sync поддерживают только Chrome 49+ и Edge 79+. В Firefox и Safari эта функция отсутствует, поэтому скилл требует реализовывать фолбэк через событие navigator.onLine.

Исходный текст

SKILL.md · MIT
---
name: service-worker
description: |
  Service worker lifecycle, caching strategies, background sync, push notifications, and static routing for progressive web apps. Covers Workbox v7.4 strategies (CacheFirst, NetworkFirst, StaleWhileRevalidate), workbox-precaching for app shells, Background Sync API with cross-browser fallbacks, Push API with VAPID keys, and the Service Worker Static Routing API (Chrome 123+).

  Use when registering service workers, implementing offline caching, configuring background sync, adding push notifications, optimizing fetch handling with static routes, or integrating service workers with local-first sync engines.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
user-invocable: false
---

# Service Worker

## Overview

Service workers are event-driven scripts that run in a separate thread from the main page, intercepting network requests, managing caches, and enabling offline functionality. Workbox v7.4 (maintained by the Chrome Aurora team) provides a production-ready abstraction over the low-level Cache API and fetch event handling.

**When to use:** Progressive web apps needing offline support, apps requiring push notifications, background data synchronization, app shell caching, network request optimization with static routing.

**When NOT to use:** Simple static sites served from a CDN, server-rendered apps with no offline requirements, apps where stale data is unacceptable (use network-only), prototypes where caching complexity is premature.

## Quick Reference

| Pattern                | API / Tool                           | Key Points                                          |
| ---------------------- | ------------------------------------ | --------------------------------------------------- |
| Registration           | `navigator.serviceWorker.register()` | Register in window context, scope defaults to path  |
| Precaching             | `workbox-precaching`                 | Revision-hashed app shell, injected at build time   |
| Cache-first            | `CacheFirst` strategy                | Static assets, fonts, images                        |
| Network-first          | `NetworkFirst` strategy              | API responses needing freshness                     |
| Stale-while-revalidate | `StaleWhileRevalidate` strategy      | Balance between speed and freshness                 |
| Background sync        | `workbox-background-sync`            | Replay failed requests when back online             |
| Push notifications     | Push API + Notifications API         | VAPID keys, server-sent push, offline-first display |
| Static routing         | `event.addRoutes()` in install       | Bypass fetch handler for known routes               |
| Skip waiting           | `self.skipWaiting()`                 | Activate new SW immediately, use with caution       |
| Clients claim          | `self.clients.claim()`               | Control existing tabs without reload                |
| Navigation preload     | `navigationPreload.enable()`         | Parallel network request during SW startup          |
| Update prompt          | `workbox-window` Workbox class       | Detect updates, prompt user, postMessage to SW      |
| Offline fallback       | `workbox-recipes` offlineFallback    | Serve fallback page when cache and network fail     |
| Cache expiration       | `workbox-expiration`                 | maxEntries and maxAgeSeconds per cache              |

## Browser Support Quick Reference

| Feature             | Chrome | Firefox | Safari | Edge |
| ------------------- | ------ | ------- | ------ | ---- |
| Service Workers     | 40+    | 44+     | 11.1+  | 17+  |
| Background Sync     | 49+    | No      | No     | 79+  |
| Periodic Sync       | 80+    | No      | No     | 80+  |
| Push API            | 50+    | 44+     | 16.4+  | 17+  |
| Navigation Preload  | 59+    | 99+     | 15.4+  | 18+  |
| Static Routing API  | 123+   | No      | No     | 123+ |
| Background Fetch    | 74+    | No      | No     | 79+  |
| Storage Persistence | 52+    | 55+     | 15.2+  | 79+  |

## Common Mistakes

| Mistake                                        | Correct Pattern                                                         |
| ---------------------------------------------- | ----------------------------------------------------------------------- |
| Caching API responses with CacheFirst          | Use NetworkFirst or StaleWhileRevalidate for dynamic data               |
| Calling skipWaiting unconditionally            | Prompt user before activating to avoid breaking in-flight navigations   |
| Not versioning precache manifests              | Use workbox-build or workbox-webpack-plugin to inject revision hashes   |
| Ignoring cache storage limits                  | Implement cache expiration with workbox-expiration plugin               |
| Using sync access handle in service worker     | OPFS createSyncAccessHandle is dedicated-worker only; use async methods |
| Assuming Background Sync works everywhere      | Chrome/Edge only (~80%); implement navigator.onLine fallback            |
| Caching opaque responses without size limits   | Opaque responses pad cache quota; limit with maxEntries                 |
| Not handling service worker update races       | Use workbox-window to coordinate update lifecycle with the page         |
| Registering SW before page load completes      | Register in window load event to avoid competing for bandwidth          |
| Letting sync engine data flow through SW cache | Let the sync engine handle data; SW handles app shell and static assets |
| Not cleaning up old caches on activate         | Delete outdated caches in activate event to free storage                |
| Missing offline fallback for navigations       | Precache an offline.html and serve it when network and cache both fail  |

## Workbox Package Reference

| Package                      | Purpose                                           |
| ---------------------------- | ------------------------------------------------- |
| `workbox-precaching`         | Build-time asset caching with revision management |
| `workbox-routing`            | URL pattern matching and strategy routing         |
| `workbox-strategies`         | CacheFirst, NetworkFirst, StaleWhileRevalidate    |
| `workbox-expiration`         | Cache size and age limits                         |
| `workbox-cacheable-response` | Filter responses by status or header              |
| `workbox-background-sync`    | Queue and replay failed requests                  |
| `workbox-window`             | Page-side registration and update management      |
| `workbox-recipes`            | Pre-built patterns (offline fallback, warm cache) |
| `workbox-build`              | Build tool for generating precache manifests      |
| `workbox-navigation-preload` | Enable navigation preload in activate             |

## Delegation

> If the `local-first` skill is available, delegate architecture decisions, sync engine selection, and offline data strategy to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s local-first -a claude-code -y`
> If the `electricsql` skill is available, delegate sync engine patterns, shape subscriptions, and real-time data replication to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y`

- **Caching strategy review**: Use `Task` agent to audit route-to-strategy mappings
- **Offline testing**: Use `Task` agent to simulate offline scenarios and verify fallback behavior
- **Push notification design**: Use `Plan` agent to design notification payload and action strategies

## References

- [Service worker lifecycle and update management](references/lifecycle.md)
- [Workbox caching strategies and precaching](references/caching-strategies.md)
- [Background sync with cross-browser fallbacks](references/background-sync.md)
- [Static Routing API for fetch handler bypass](references/static-routing.md)
- [Push notifications with VAPID and offline integration](references/push-notifications.md)
- [Local-first integration and storage patterns](references/local-first-patterns.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
pwa-development alinaqi Скилл pwa-development для Claude Code и других агентов: собирает PWA — манифест, service worker, стратегии кэширования и офлайн-режим. Покрывает установку на телефон и работу без сети. CX Codex +1 4 600установок progressive-web-app secondsky Скилл progressive-web-app для Claude Code и ещё пяти агентных сред, который помогает собирать устанавливаемые веб-приложения. Подключается, когда нужен service worker, манифест, офлайн-режим или push-уведомления. CX Codex +1 544установок pwa-expert curiositech Скилл pwa-expert для Claude Code и других агентов: Service Worker, офлайн-режим, установка на устройство. Превращает веб-приложение в устанавливаемое или работающее без сети. CX Codex +1 579установок chrome-extensions GoogleChrome Скилл chrome-extensions помогает создавать и публиковать расширения для Chrome по стандартам Manifest V3. Задаёт правила для фоновых скриптов, боковых панелей и разрешений. CX Codex +1 16 200установок chrome-extension samber Скилл chrome-extension для Claude Code создаёт и дорабатывает Chrome-расширения на Manifest V3, включая manifest.json, content scripts, фоновую логику и API браузера. CX Codex +1 5 300установок chrome-extension-development Mindrally Скилл chrome-extension-development для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode задаёт правила разработки расширений Chrome на Manifest V3: архитектура, безопасность, chrome.* API и публикация. CX Codex +1 3 000установок

Из того же набора106

Весь набор →
shell-integration Скилл shell-integration для Claude Code содержит шаблоны интеграции с Bash, Zsh и Fish: автодополнения, хуки и переносимые скрипты. CX Codex +1 123установок usability-tester Скилл usability-tester помогает спланировать юзабилити-тестирование, оценить сценарии по эвристикам Нильсена и приоритизировать UX-проблемы по формуле критичности. CX Codex +1 122установок react-email Скилл react-email для Claude Code собирает адаптивные HTML-письма из React-компонентов и выводит их в HTML или обычный текст. Создаёт транзакционные письма и маркетинговые шаблоны. CX Codex +1 122установок rag-implementer Скилл rag-implementer ведёт агента по шагам RAG-пайплайна: от чанкинга и эмбеддингов до гибридного поиска и замеров качества. CX Codex +1 121установок cli-power-tools Скилл cli-power-tools учит ИИ-агента современным утилитам на Rust и структурированным конвейерам вместо связок grep, sed и awk. CX Codex +1 121установок quality-auditor Скилл quality-auditor проводит аудит кода по 12 взвешенным измерениям, ставит оценки с опорой на доказательства и собирает план улучшений. CX Codex +1 120установок package-publishing Скилл package-publishing помогает настроить package.json, сборку ESM и CJS и публикацию TypeScript-библиотеки в npm. Пригодится при настройке точек входа и проверок перед релизом. CX Codex +1 119установок svelte Справочник по Svelte 5 и SvelteKit для ИИ-агента: руны, сниппеты, роутинг, form actions и таблица перевода кода с Svelte 4. CX Codex +1 117установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой