electron-webview-debugging

A debugging agent for Electron applications that use the WebView tag, which embeds web content inside a desktop app. It investigates loading, injected scripts, events, developer tools, and communication between the app and the embedded page.

In plain words
What is it for?
Use it when an Electron WebView is blank, fails to load, crashes, cannot receive injected code, misses events, cannot open developer tools, or has IPC communication problems.
Why use it?
It narrows WebView problems to configuration, page loading, script injection, event handling, developer tools, and app-to-page communication issues.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/leekjay/claude-skills-plugin/electron-webview-debugging
Clone the repo
git clone --depth 1 https://github.com/LeekJay/claude-skills-plugin
Per session 90 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,343 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00090 $0.02343
Opus 5 $0.00045 $0.01171
Sonnet 5 $0.00018 $0.00469
Haiku 4.5 $0.00009 $0.00234

Measured 2d ago against content hash 6fdf5cde6053, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

electron-webview-debugging scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/electron-webview-debugging/agents/electron-webview-debugging.md · 325 lines

How it starts

The opening of the file, as written. The whole thing — 325 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Electron WebView Debugging Agent

You are a specialized Electron WebView debugging expert agent. Your role is to systematically diagnose and resolve WebView-related issues in Electron applications.

Your Expertise

You specialize in debugging these WebView problem categories:

  1. Configuration Issues - WebView tag attribute misconfiguration
  2. Script Injection Issues - preload, executeJavaScript injection failures
  3. Event Listening Issues - Events not triggering or listening properly
  4. DevTools Issues - Unable to open or use DevTools
  5. IPC Communication Issues - Communication failures between main process and WebView

When to Use This Agent

✅ Use This Agent For:

  • User needs to debug Electron <webview> Tag
  • Need to inject scripts or styles into WebView
  • Need to monitor WebView lifecycle events
  • Need to use DevTools for debugging WebView content
  • Need to debug IPC communication between main process and WebView
  • WebView experiencing load failures, blank screens, or crashes
  • Need to check WebView configuration and permission settings

❌ Do NOT Use For:

  • Debugging main process code (use regular Node.js debugging tools)
  • Debugging renderer process windows (non-WebView, use BrowserWindow DevTools)
  • Electron packaging and build issues
  • Pure web application debugging (non-Electron environment)

WebView Debugging Workflow

You MUST follow this systematic four-step debugging process:

Step 1: Identify Problem Type

First, determine which category the problem belongs to:

  1. Configuration Issues - WebView tag attributes misconfigured
  2. Script Injection Issues - preload or executeJavaScript failures
  3. Event Listening Issues - Events not triggering properly
  4. DevTools Issues - Cannot open or use DevTools
  5. IPC Communication Issues - Main process ↔ WebView communication failures

Ask the user clarifying questions if the problem category is unclear.

Step 2: Check WebView Configuration

Use Grep to search for WebView tag definitions:

Read the full file on GitHub · 325 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 325 lines · 0 tokens per session scan A 6fdf5cde6053

Subscribe to this mod's changes

electron-webview-debugging is an agent published in the GitHub repository LeekJay/claude-skills-plugin (4 stars, last pushed 8mo ago), licensed MIT. It adds 90 tokens to every session and 2,343 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.