docs(skills): add kernel-browser-telemetry skill

[juecd]

Documents the browser telemetry CLI (categories, historical reads, live streaming) as its own skill, and points kernel-cli at it so agents check telemetry before reaching for a screenshot.

---

Note

Low Risk
Documentation-only changes to skills and README; no runtime, auth, or API behavior is modified.

Overview
Introduces a new kernel-browser-telemetry agent skill that documents Kernel browser telemetry end-to-end: opt-in --telemetry categories at create/update, a category/event-type reference, kernel browsers telemetry events (filters, pagination, --all), and telemetry stream (filters, JSON envelopes, replay, --seq resume), plus a telemetry-first navigation workflow.

kernel-cli is updated so the quick-start session create enables console,network,page, Safe Operation tells agents to confirm state via telemetry before screenshots, and References link to the new skill. README lists the skill in the kernel-cli table.

^{Reviewed by Cursor Bugbot for commit 2a5779f. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

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

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

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 2a5779f. Configure here.}

[cursor]

Wrong telemetry stream replay flag

Medium Severity

The stream example documents --replay=all, but the Kernel CLI exposes a boolean --replay-all flag (API replay=all is not the CLI form). Agents following this skill hit an unrecognized-flag error instead of replaying retained events.

 

^{Triggered by learned rule: Skill docs must not misrepresent tool/SDK capabilities at documented version}

^{Reviewed by Cursor Bugbot for commit 2a5779f. Configure here.}

[cursor]

Full telemetry catalog pasted

Medium Severity

The Categories section pastes a full category-to-event-type catalog instead of a short high-signal set plus a link to the canonical telemetry categories docs. The table already drifts: it omits the monitor category (monitor_disconnected / monitor_reconnected) and page_crashed, so agents miss gap and crash signals.

 

^{Triggered by learned rule: Skill docs must cross-reference, not duplicate other skills}

^{Reviewed by Cursor Bugbot for commit 2a5779f. Configure here.}

[cursor]

Opt-in precondition buried later

Medium Severity

The new skill leads with “check telemetry first / replace sleep + screenshot” before stating that capture is opt-in and off by default. The kernel-cli Safe Operation bullet makes the same “check telemetry first” claim without that precondition, so mid-debug agents can chase an empty event history on sessions where telemetry was never enabled.

Additional Locations (1)

• plugins/kernel-cli/skills/kernel-cli/SKILL.md#L49-L50

 

^{Triggered by learned rule: Skill docs must lead with preconditions for opt-in features}

^{Reviewed by Cursor Bugbot for commit 2a5779f. Configure here.}