Skip to content

Port MCP debug-browser-session prompt to a kernel-cli skill#29

Merged
masnwilliams merged 2 commits into
mainfrom
hypeship/port-mcp-debug-browser-session
Jun 26, 2026
Merged

Port MCP debug-browser-session prompt to a kernel-cli skill#29
masnwilliams merged 2 commits into
mainfrom
hypeship/port-mcp-debug-browser-session

Conversation

@masnwilliams

@masnwilliams masnwilliams commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Ports the debug-browser-session prebuilt prompt shipped by the Kernel MCP server into a standalone skill under the kernel-cli plugin, so users get the guide via the skills marketplace without installing the MCP.

The skill mirrors the MCP prompt's content: a systematic Kernel CLI workflow for diagnosing a misbehaving browser session — session status, screenshots, Playwright page inspection, VM log reads, in-VM network checks, common-issue triage (bot detection, Chrome crashes, page-load/DNS, live-view/WebRTC), expected-noise log entries, and a debugging checklist. It takes a session ID + issue description as inputs.

⚠️ Naming overlap with PR #23

There is already an open PR (#23) that adds a skill also named debug-browser-session, but it's a different skill: a client-side CDP-disconnect debugging guide under kernel-sdks. This PR is the port of the MCP prompt (CLI-based VM debugging under kernel-cli).

Two skills can't share the name debug-browser-session across installed plugins. Before merging, we should decide:

Flagging rather than resolving unilaterally.

Test plan


Note

Low Risk
Documentation-only skill and README table entry; no runtime or auth changes.

Overview
Adds a debug-browser-session skill under kernel-cli by porting the Kernel MCP server’s prebuilt debugging prompt into the skills marketplace, so agents can follow the workflow without MCP.

The skill documents a session ID + issue description driven flow: kernel browsers get, screenshots, Playwright page inspection, VM log reads, in-VM curl/DNS checks, triage for bot detection, Chrome crashes, page-load/DNS, and live-view/WebRTC, plus benign log noise and a checklist. README lists the new skill in the kernel-cli table.

Note: Another open PR may use the same skill name under kernel-sdks (CDP-focused); only one debug-browser-session can coexist across plugins—rename or merge before shipping both.

Reviewed by Cursor Bugbot for commit 998c7bf. Bugbot is set up for automated code reviews on this repo. Configure here.

Port the kernel-mcp-server debug-browser-session prompt into a skill so
it's available via the skills marketplace without installing the MCP.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@masnwilliams masnwilliams marked this pull request as ready for review June 26, 2026 15:27

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 6 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit f3fe265. Configure here.

Comment thread plugins/kernel-cli/skills/debug-browser-session/SKILL.md
Comment thread plugins/kernel-cli/skills/debug-browser-session/SKILL.md
Comment thread plugins/kernel-cli/skills/debug-browser-session/SKILL.md Outdated
Comment thread plugins/kernel-cli/skills/debug-browser-session/SKILL.md
Comment thread plugins/kernel-cli/skills/debug-browser-session/SKILL.md Outdated
Comment thread plugins/kernel-cli/skills/debug-browser-session/SKILL.md
@masnwilliams

Copy link
Copy Markdown
Contributor Author

Closing — built off a misread of the original ask. The debug-browser-session prompt already ships as a first-class MCP Prompt in kernel-mcp-server, which covers the need. No skills.sh port required right now.

- Correct screenshot command to `browsers computer screenshot --to`
- Correct file listing to `browsers fs list-files`
- Note stealth is creation-time; recreate session rather than toggle
- Add `browsers view` to live-view troubleshooting
- Cross-reference kernel-cli skill instead of re-documenting install/auth

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@masnwilliams masnwilliams requested a review from dprevoznik June 26, 2026 18:51

@dprevoznik dprevoznik left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@masnwilliams masnwilliams merged commit 055e2c2 into main Jun 26, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants