stackblitz-common-errors
/stackblitz-common-errors
Diagnozuje błędy startu WebContainer, izolacji, Service Workera, zależności, procesów i podglądu w przeglądarce na podstawie dowodów, zanim zmieni kod lub nagłówki.
- Autor
- jeremylongshore ↗
- Repozytorium
- tons-of-skills-marketplace ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Diagnozuje błędy startu WebContainer, izolacji, Service Workera, zależności, procesów i podglądu w przeglądarce na podstawie dowodów, zanim zmieni kod lub nagłówki.
Wyzwalacze z opisu
Argumenty
/stackblitz-common-errors [project-path] [symptom]
Oryginalny opis (EN)
Diagnose WebContainer startup, isolation, Service Worker, dependency, process, preview, and browser failures from evidence before changing code or headers. Use when a StackBlitz runtime or embed fails, hangs, or behaves differently across browsers. Trigger with "StackBlitz error", "WebContainer failed to boot", or "SharedArrayBuffer error".
Jak działa
- Overview
- Prerequisites
- Tool Discipline
- Current Contract
- Authentication
- Workflow
- Approval Boundaries
- Output
- Error Handling
- Examples
Podgląd SKILL.md
--- name: stackblitz-common-errors description: >- Diagnose WebContainer startup, isolation, Service Worker, dependency, process, preview, and browser failures from evidence before changing code or headers. Use when a StackBlitz runtime or embed fails, hangs, or behaves differently across browsers. Trigger with "StackBlitz error", "WebContainer failed to boot", or "SharedArrayBuffer error". argument-hint: "[project-path] [symptom]" allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit version: 1.7.0 author: Jeremy Longshore <jeremy@intentsolutions.io> license: MIT tags: - saas - stackblitz - troubleshooting - webcontainers model: inherit effort: medium compatibility: Designed for Claude Code --- # WebContainer Failure Triage ## Overview This skill follows a deterministic diagnosis order: browser capability, served headers, lifecycle ownership, runtime events, process exit, dependency compatibility, and preview behavior. It avoids speculative retries and unsafe header weakening. ## Prerequisites - A reproducible URL or local command and the affected browser/version - Permission to inspect application code, response headers, and bounded browser/runtime logs - A synthetic reproduction when the failing project contains sensitive data ## Tool Discipline Use `Read`, `Glob`, and `Grep` to find boot calls, headers, runtime events, process handling, and dependency manifests. Use `WebFetch` only for current official StackBlitz or WebContainers documentation. Use `Write` or `Edit` only after the failing layer is identified; never retrieve secrets or full user projects for diagnosis. ## Current Contract - A SharedArrayBuffer or `crossOriginIsolated` failure starts with the actual HTML response's COOP/COEP headers, including `304` behavior. - A released proxy or duplicate-start failure requires proving whether `boot()` ran more than once, including under HMR. - Dependency installs should preserve exit code and bounded output; a lockfile can improve repeatability and startup time. - Native Node addons are unavailable unless an alternative is implemented in JavaScript or WebAssembly. - Browser privacy controls can block required Service Worker or third-party storage behavior. - Preview failures are investigated through process exit plus `error`, `port`, and `server-ready` events. ## Authentication Redact API keys, registry tokens, OAuth details, cookies, source contents, and dynamic preview URLs from shared evidence. For private-package failures, report auth state and package identity without printing credential values. ## Workflow 1. Reproduce with the smallest synthetic project and record browser, URL, secure-context, and isolation state. 2. Inspect the final document headers and cached response behavior. 3. Count boot paths and trace HMR, navigation, and teardown ownership. 4. Capture bounded runtime events, spawned command, exit code, and the final useful output lines. 5. Compare the dependency with documented WebContainer constraints, especially native addons and install behavior. 6. Apply one layer-specific fix, repeat the reproduction, and record rollback plus remaining browser variance. ## Approval Boundaries Do not disable browser security, relax COOP/COEP or CSP broadly, clear user browser data, replace dependencies, or change production hosting without explicit authorization. Present the failing layer and narrow fix first. ## Output Return the reproduction, evidence by layer, root cause or ranked hypotheses, exact fix made or proposed, verification, redactions, rollback, and unresolved compatibility risk. ## Error Handling | Symptom | Evidence-led response | |---|---| | SharedArrayBuffer transfer fails | Verify secure context, COOP/COEP, matching boot option, and cached headers. | | Proxy is released | Find duplicate boot or premature teardown paths, including HMR. | | Install stalls or fails | Preserve lockfile state, exit code, and bounded output; inspect native-addon use. | | Preview never appears | Correlate process exit with `port`, `error`, and `server-ready` events. | ## Examples For a preview that works in Chromium but fails in Firefox private browsing, record browser constraints and Service Worker evidence, preserve a static fallback, and avoid changing the runtime code without a cross-browser reproduction. ## Resources - [Official StackBlitz and WebContainers references](references/official-docs.md) - [WebContainers troubleshooting](https://webcontainers.io/guides/troubleshooting) - [Browser configuration](https://webcontainers.io/guides/browser-config)
Pliki w paczce (2)
- SKILL.md 4 KB
- references/official-docs.md 1 KB
Wersje
W bazie nie ma innych skilli o nazwie stackblitz-common-errors.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 806c57b4cf94 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100stackblitz-install-auth
Przygotowuje integrację StackBlitz WebContainer lub JavaScript SDK z przypiętymi pakietami, zgodnymi nagłówkami izolacji i właściwą ścieżką uwierzytelniania dla licencji komercyjnej lub pakietów prywatnych. - 100stackblitz-debug-bundle
Tworzy diagnostyczny pakiet WebContainer bez danych wrażliwych, z dowodami o przeglądarce, nagłówkach izolacji, cyklu życia, zdarzeniach, procesach i zasobach, do udostępnienia przy incydencie. - 100cross-origin-isolation
Sprawdza aplikacje webowe wymagające izolacji między źródłami, na przykład z SharedArrayBuffer czy workerami, weryfikując zarówno nagłówki, jak i zachowanie w przeglądarce. - 95fixatlas-diagnose-error
Diagnozuje błędy kompilatora, menedżerów pakietów, uruchomienia, Gita i budowania na podstawie dowodów z logów. - 100perplexity-common-errors
Diagnozuje i naprawia typowe błędy i wyjątki Perplexity, w tym nieudane żądania i problemy integracji. - 100linear-common-errors
Diagnozuje i naprawia typowe błędy API Linear, w tym problemy z uwierzytelnianiem, przydatne przy debugowaniu integracji.