debug-remote_skill

Overview

This skill helps you capture and inspect logs, errors, and telemetry from TV apps remotely. It focuses on practical tools for on-screen logging, network-forwarding of logs, and leveraging ADB logcat when available. The goal is fast reproduction and diagnosis of platform-specific issues that are invisible on TV screens.

How this skill works

It injects a lightweight on-screen console overlay that surfaces console output directly on the TV and provides a remote logging option to forward events to a webhook or log drain. When ADB is available, it recommends filtered logcat usage and a unique log prefix to extract relevant lines. A global debug object lets you toggle overlay and configure the remote endpoint at runtime.

When to use it

• When console.log output is not visible on the TV screen.
• When you need live observation of runtime errors during manual QA on a TV device.
• For remote teams to capture logs from testers who cannot run ADB.
• When intermittent issues require persistent, timestamped telemetry for later analysis.

Best practices

• Use a unique log prefix (e.g., [APP]) so ADB or server-side filters can extract only your app logs.
• Keep the overlay lightweight and toggleable to avoid UI interference during normal use.
• Send logs fire-and-forget to a secure endpoint; avoid blocking UI with large synchronous requests.
• Redact or avoid sending sensitive user data in remote logs; use sampling for high-volume events.
• Fallback to ADB logcat for full system context when you can connect a device physically.

Example use cases

• Enable the on-screen console with the Konami code during a QA session to reveal hidden errors without a laptop.
• Configure the remote server URL in the debug object to collect logs from remote testers via a webhook.
• Use adb logcat | grep "[APP]" to capture crash traces and Chromium network errors when debugging playback failures.
• Capture focus and input events on TV to diagnose focus traps that break navigation with the remote control.
• Add lightweight telemetry for image loading and memory hints to detect leaks or heavy memory usage on TVs.