Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

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.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

StackBlitz errorWebContainer failed to bootSharedArrayBuffer error

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

  1. Overview
  2. Prerequisites
  3. Tool Discipline
  4. Current Contract
  5. Authentication
  6. Workflow
  7. Approval Boundaries
  8. Output
  9. Error Handling
  10. Examples
Sekcje z nagłówków SKILL.md, w oryginale · 65 linii, 517 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.