[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EVK5G7R6YDFCCKZGVTMBK5":3,"skill-same:01M7EVK5G7R6YDFCCKZGVTMBK5":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7EVK5G7R6YDFCCKZGVTMBK5","ams-pwa-craftsman",null,"TanNhatCMS\u002Fjarvis","TanNhatCMS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113796420?v=4","01M753MV17KG5CD3152G3WQEQY","KietNT","01M7EKEDYVYQ6PWVJJMZ911VMX",0,"MIT","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-pwa-craftsman\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pwa-craftsman\ndescription: Build excellent Progressive Web Apps: manifests, service workers, offline strategy, installability, and app-like UX. Use when building or reviewing PWAs.\ncategory: development\n---\n\n# PWA Craftsman\n\n## Overview\n\nA great PWA — **installable, offline-capable, and app-like** — is a craft of details: the manifest\nthat makes it installable, the service worker that makes it reliable, caching strategies matched to\ncontent types, and UX that respects connectivity. This skill covers building PWAs that feel native\nrather than \"a website with a manifest.\"\n\nThe through-line: reliable (works offline), fast (instant loads), engaging (installable, push-capable)\n— in that order.\n\n## When to use\n\n- Building a new PWA or converting a web app.\n- Designing offline support and caching strategies.\n- Debugging service worker issues (stale content, update flows).\n- Improving installability, push notifications, or app-like UX.\n- Auditing an existing PWA against quality criteria.\n\n## Core concepts\n\n- **The manifest.** `manifest.json`: name, icons (maskable + any, multiple sizes), theme\u002Fbackground\n  colors, display mode (`standalone`), start URL, shortcuts, share target. This is the install\n  contract — get icons and colors right, because they're the app's face on the home screen.\n- **Service worker lifecycle.** Install → activate → fetch interception; versioned caches;\n  `skipWaiting` + `clients.claim` for prompt updates (or deliberate delayed updates). The #1 PWA\n  bug class is lifecycle confusion — learn it cold before writing strategies.\n- **Caching strategies per content type.** This is the core design work:\n  - App shell (HTML\u002FCSS\u002FJS): precache, cache-first with versioned updates.\n  - API data: stale-while-revalidate (fresh UI, background refresh) or network-first with cache\n    fallback for must-be-fresh data.\n  - Images\u002Fmedia: cache-first with quota management.\n  - Truly dynamic: network-only.\n  One strategy for everything is always wrong.\n- **Offline as a designed state.** Not just \"cached shell + spinner\" — queued mutations (background\n  sync), clear offline UI, conflict resolution policy for synced data. Offline support is a product\n  decision with UX design, not a service worker flag.\n- **Installability criteria.** HTTPS, manifest with icons, service worker with fetch handler,\n  and meeting the browser's engagement heuristics. Plus the UX: *when* to prompt (after value\n  demonstrated, not on first visit) and a graceful custom install button.\n- **Push notifications (with restraint).** Push API + Notifications API via the service worker;\n  VAPID keys; user permission requested in context with clear value. Notifications are a\n  retention tool that becomes an uninstall tool when abused — every push must earn the next one.\n\n## Practical workflow\n\n1. **Start with the baseline.** HTTPS, responsive design, and a fast site — a slow broken site\n   with a manifest is still a slow broken site. Lighthouse PWA audit as the starting scorecard.\n2. **Write the manifest.** Complete icons (192\u002F512 + maskable), theme colors matching the UI,\n   `display: standalone`, shortcuts to key actions. Validate with DevTools → Application.\n3. **Build the service worker with Workbox (or hand-rolled if small).** Precache the app shell\n   (build-integrated revisioning); runtime caching routes per content type with the right strategy;\n   quota\u002Fexpiration policies so caches don't grow unboundedly.\n4. **Design offline UX.** Offline page\u002Ffallbacks, queued actions with background sync, \"you're\n   offline\" states that explain what's available. Test with DevTools offline + real airplane mode.\n5. **Handle updates gracefully.** New service worker → notify user (\"Update available\") rather\n   than force-reloading mid-task; or auto-update for non-critical apps. Never strand users on\n   stale versions silently, never yank the rug mid-flow.\n6. **Add engagement carefully.** Custom install prompt at the right moment; push only for\n   genuinely time-sensitive, user-valued events; notification settings in-app. Measure opt-in and\n   disable rates — they're the truth about your push strategy.\n\nCaching strategy map:\n\n```text\n\u002Fapp-shell (\u002F, \u002Fstyles\u002F*, \u002Fapp.js)   → precache, cache-first (versioned at build)\nGET \u002Fapi\u002Ffeed                        → stale-while-revalidate (5 min max age)\n\u002Fapi\u002Fuser\u002F* (must be fresh)          → network-first, cache fallback on failure\n\u002Fimages\u002F*                            → cache-first, max 200 entries, 30-day expiry\nPOST \u002Fapi\u002F* (mutations)              → network-only + background-sync queue when offline\n```\n\n## Common pitfalls\n\n- **Cache-everything service worker.** One cache-first strategy for all routes = stale API data\n  and confused users. Strategies per content type, always.\n- **Update purgatory.** Users stuck on old versions because the new SW never activates (or\n  activates mid-session breaking state). Deliberate update UX: notify + user-triggered reload.\n- **Unbounded caches.** Caching every image forever until storage pressure evicts *everything*\n  unpredictably. Expiration + max entries on every runtime cache.\n- **Offline as an accident.** \"It kind of works offline\" — untested, with spinners and broken\n  mutations. Offline is a feature: design, implement, and test it like one.\n- **Install prompt on first paint.** Begging for installation before demonstrating value —\n  dismissed forever. Prompt after the aha moment; provide a persistent manual install entry point.\n- **Notification spam.** Every marketing whim as a push. Permission revoked, app uninstalled.\n  High-value, user-controlled, infrequent — or don't do push at all.\n- **iOS assumptions.** Safari's PWA support has real gaps\u002Flimits (push arrived late, storage\n  limits, no install prompt API — manual share-menu install). Design for the weakest platform you\n  support; test on real iOS.\n","# PWA Craftsman\n\n## Overview\n\nA great PWA — **installable, offline-capable, and app-like** — is a craft of details: the manifest\nthat makes it installable, the service worker that makes it reliable, caching strategies matched to\ncontent types, and UX that respects connectivity. This skill covers building PWAs that feel native\nrather than \"a website with a manifest.\"\n\nThe through-line: reliable (works offline), fast (instant loads), engaging (installable, push-capable)\n— in that order.\n\n## When to use\n\n- Building a new PWA or converting a web app.\n- Designing offline support and caching strategies.\n- Debugging service worker issues (stale content, update flows).\n- Improving installability, push notifications, or app-like UX.\n- Auditing an existing PWA against quality criteria.\n\n## Core concepts\n\n- **The manifest.** `manifest.json`: name, icons (maskable + any, multiple sizes), theme\u002Fbackground\n  colors, display mode (`standalone`), start URL, shortcuts, share target. This is the install\n  contract — get icons and colors right, because they're the app's face on the home screen.\n- **Service worker lifecycle.** Install → activate → fetch interception; versioned caches;\n  `skipWaiting` + `clients.claim` for prompt updates (or deliberate delayed updates). The #1 PWA\n  bug class is lifecycle confusion — learn it cold before writing strategies.\n- **Caching strategies per content type.** This is the core design work:\n  - App shell (HTML\u002FCSS\u002FJS): precache, cache-first with versioned updates.\n  - API data: stale-while-revalidate (fresh UI, background refresh) or network-first with cache\n    fallback for must-be-fresh data.\n  - Images\u002Fmedia: cache-first with quota management.\n  - Truly dynamic: network-only.\n  One strategy for everything is always wrong.\n- **Offline as a designed state.** Not just \"cached shell + spinner\" — queued mutations (background\n  sync), clear offline UI, conflict resolution policy for synced data. Offline support is a product\n  decision with UX design, not a service worker flag.\n- **Installability criteria.** HTTPS, manifest with icons, service worker with fetch handler,\n  and meeting the browser's engagement heuristics. Plus the UX: *when* to prompt (after value\n  demonstrated, not on first visit) and a graceful custom install button.\n- **Push notifications (with restraint).** Push API + Notifications API via the service worker;\n  VAPID keys; user permission requested in context with clear value. Notifications are a\n  retention tool that becomes an uninstall tool when abused — every push must earn the next one.\n\n## Practical workflow\n\n1. **Start with the baseline.** HTTPS, responsive design, and a fast site — a slow broken site\n   with a manifest is still a slow broken site. Lighthouse PWA audit as the starting scorecard.\n2. **Write the manifest.** Complete icons (192\u002F512 + maskable), theme colors matching the UI,\n   `display: standalone`, shortcuts to key actions. Validate with DevTools → Application.\n3. **Build the service worker with Workbox (or hand-rolled if small).** Precache the app shell\n   (build-integrated revisioning); runtime caching routes per content type with the right strategy;\n   quota\u002Fexpiration policies so caches don't grow unboundedly.\n4. **Design offline UX.** Offline page\u002Ffallbacks, queued actions with background sync, \"you're\n   offline\" states that explain what's available. Test with DevTools offline + real airplane mode.\n5. **Handle updates gracefully.** New service worker → notify user (\"Update available\") rather\n   than force-reloading mid-task; or auto-update for non-critical apps. Never strand users on\n   stale versions silently, never yank the rug mid-flow.\n6. **Add engagement carefully.** Custom install prompt at the right moment; push only for\n   genuinely time-sensitive, user-valued events; notification settings in-app. Measure opt-in and\n   disable rates — they're the truth about your push strategy.\n\nCaching strategy map:\n\n```text\n\u002Fapp-shell (\u002F, \u002Fstyles\u002F*, \u002Fapp.js)   → precache, cache-first (versioned at build)\nGET \u002Fapi\u002Ffeed                        → stale-while-revalidate (5 min max age)\n\u002Fapi\u002Fuser\u002F* (must be fresh)          → network-first, cache fallback on failure\n\u002Fimages\u002F*                            → cache-first, max 200 entries, 30-day expiry\nPOST \u002Fapi\u002F* (mutations)              → network-only + background-sync queue when offline\n```\n\n## Common pitfalls\n\n- **Cache-everything service worker.** One cache-first strategy for all routes = stale API data\n  and confused users. Strategies per content type, always.\n- **Update purgatory.** Users stuck on old versions because the new SW never activates (or\n  activates mid-session breaking state). Deliberate update UX: notify + user-triggered reload.\n- **Unbounded caches.** Caching every image forever until storage pressure evicts *everything*\n  unpredictably. Expiration + max entries on every runtime cache.\n- **Offline as an accident.** \"It kind of works offline\" — untested, with spinners and broken\n  mutations. Offline is a feature: design, implement, and test it like one.\n- **Install prompt on first paint.** Begging for installation before demonstrating value —\n  dismissed forever. Prompt after the aha moment; provide a persistent manual install entry point.\n- **Notification spam.** Every marketing whim as a push. Permission revoked, app uninstalled.\n  High-value, user-controlled, infrequent — or don't do push at all.\n- **iOS assumptions.** Safari's PWA support has real gaps\u002Flimits (push arrived late, storage\n  limits, no install prompt API — manual share-menu install). Design for the weakest platform you\n  support; test on real iOS.\n",{},"main","af388a77c2fe5e0b4fd879cca4300a0ffa9a6579","skills\u002Fams-pwa-craftsman",1,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis","https:\u002F\u002Fgithub.com\u002FTanNhatCMS","https:\u002F\u002Fmrkiet.name.vn","2026-11-07 14:23:08",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add TanNhatCMS\u002Fjarvis --skill ams-pwa-craftsman",{"tool":37,"command":38},"bunx","bunx skills add TanNhatCMS\u002Fjarvis --skill ams-pwa-craftsman",{"tool":40,"command":41},"pnpm","pnpm dlx skills add TanNhatCMS\u002Fjarvis --skill ams-pwa-craftsman","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-pwa-craftsman\u002FSKILL.md",true,[],[46,53,61,68,75,82],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7EWYJR0J8DARY7E59Z6Y9MV","web-scrape","Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open\u002Ffetch fails on JS-heavy pages, or when you need clean markdown\u002Fstructured extraction from a site. Requires FIRECRAWL_API_KEY.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fweb-scrape\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":57,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7EWYBN5P6F2AJG3FR24T9BP","design-taste-frontend","tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML\u002FCSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, \"AI-made\", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EWY8FQFNQ2GB7NZZWGSSDX","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-tdd\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7EWY5SHBFRH1HDHVWM9K7TV","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-debugging\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7EWY3NM0Z0JAKS7HDZ24K66","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-code-review\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7EWY0WRMWX4M9ZFY0WKC593","brainstorming","You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-brainstorming\u002FSKILL.md",[],[]]