service-worker — скилл для Claude Code: что делает и как установить
Скилл service-worker для Claude Code собирает правила настройки сервис-воркеров, Workbox v7.4, офлайн-кеширования, фоновой синхронизации и push-уведомлений.
MIT 121 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill service-worker -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/service-worker/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/service-worker/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill service-worker -a codex2Вручную: положить файлы
.agents/skills/service-worker/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill service-worker -a cursor2Вручную: положить файлы
.cursor/skills/service-worker/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/service-worker2Вручную: положить файлы
.github/skills/service-worker/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill service-worker -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/service-workerВручную: положить файлы
.devin/skills/service-worker/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill service-worker -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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