Index of every page on this site: llms.txt
All skills
jeremylongshore avatar

/stackblitz-install-auth

@820dfc8
Run it yourself

Prepare a StackBlitz WebContainer or JavaScript SDK integration with pinned packages, compatible isolation headers, and the correct commercial or private-package authentication path. Use when adding StackBlitz to an existing web application or reviewing its startup contract. Trigger with "install StackBlitz", "set up WebContainers", or "configure WebContainer auth".

Use this Skill: https://skilld.dev/gh/jeremylongshore/tons-of-skills-marketplace/stackblitz-install-auth

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈98 tokens for metadata: the name and description. ≈1.1k when used: this file. ≈273 more on demand in 1 file.

Description uses 4.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈394 characters, or 4.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

StackBlitz Integration Preflight

Overview

This skill produces a repo-grounded installation and startup plan for either a custom WebContainer application or a StackBlitz SDK embed. It separates ordinary browser startup from commercial API-key configuration and organization-scoped private-package authentication.

Prerequisites

  • A named browser application and permission to inspect its package and hosting configuration
  • A decision between @webcontainer/api and @stackblitz/sdk, or evidence that both are needed
  • A licensing decision for production commercial use before release

Tool Discipline

Use Read, Glob, and Grep to inspect package manifests, lockfiles, browser entrypoints, headers, and existing secret bindings. Use WebFetch only for current official StackBlitz or WebContainers documentation. Use Write or Edit only after the evidence pass, and never place API keys or OAuth material in source files.

Current Contract

  • Pin the package version selected by the repository's dependency policy; do not install an unreviewed moving tag.
  • Call configureAPIKey before WebContainer.boot() when a commercial license supplies an API key.
  • Call auth.init before boot when organization users need private-package access; the user must be logged in, belong to the issuing organization, and authorize the site.
  • Match the Cross-Origin-Embedder-Policy response header to the coep boot option. Use HTTPS outside localhost.
  • A StackBlitz SDK embed is a separate surface and does not require booting a custom WebContainer in the host application.

Authentication

Public prototypes may not need user authentication, but production commercial use requires a licensing review. Treat the WebContainer API key as a secret runtime binding. Treat the auth client ID and scope as configuration, initialize auth during page loading, and handle need-auth, authorized, and auth-failed explicitly. Never infer that ordinary StackBlitz login grants access to private packages.

Workflow

  1. Inspect the framework, package manager, lockfile, client/server boundary, CSP, and current response-header configuration.
  2. Choose the minimum package surface and record the installed or proposed pinned version.
  3. Decide whether the integration needs a commercial API key, organization auth, neither, or both.
  4. Configure consistent COOP/COEP headers and the matching boot option; verify the final HTML response, including cached responses.
  5. Add one startup module that orders API-key configuration, auth initialization, and the single boot call correctly.
  6. Validate in a supported desktop browser over the same origin and headers intended for deployment.

Approval Boundaries

Default to inspection and a proposed patch. Require explicit authorization before changing production headers, CSP, identity-provider settings, licensed API-key bindings, or deployment configuration. Never create, rotate, expose, or revoke a credential without a separately authorized operational step.

Output

Return the selected integration mode, package/version evidence, licensing and auth decision, header/boot contract, changed or proposed files, verification results, rollout plan, rollback, and unresolved browser or policy risks.

Error Handling

Condition Response
API key configured after boot Stop and move configuration before the first boot call.
Auth reports need-auth Present the user-authorized flow; do not loop or fabricate authorization.
crossOriginIsolated is false Inspect actual response headers and cache behavior before changing code.
Integration mode is unclear Compare custom runtime requirements with embed-only requirements before installing both SDKs.

Examples

Given an existing Vite app, identify its lockfile and hosting headers, select a pinned WebContainer API version, document whether commercial licensing applies, and propose a single ordered startup module without reading any secret value.

Resources

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill provides instructions for installing and configuring StackBlitz and WebContainer APIs. It uses standard package installation commands and configuration snippets for well-known services. No security issues were detected.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 820dfc8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated 2 months ago
What it can do
Reads files Network Edits files
Modelinherit
argument-hint
[project-path] [webcontainer|embed]
version
1.7.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
All 6 allowed tools
ReadGlobGrepWebFetchWriteEdit
Other metadata
tags
[
  "saas",
  "stackblitz",
  "webcontainers",
  "setup"
]
model
inherit
effort
medium
compatibility
Designed for Claude Code

README badge

README badge for jeremylongshore/tons-of-skills-marketplace/stackblitz-install-auth