meta-wearables-debugging-observability

Diagnose Meta Wearables DAT iOS and Android failures with redacted, source-grounded evidence.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/shotcowboystyle/meta-wearables-ops-plugin --skill meta-wearables-debugging-observability-shotcowboystyle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meta-wearables-debugging-observability
Source: https://github.com/shotcowboystyle/meta-wearables-ops-plugin/tree/main/.agent/skills/meta-wearables-debugging-observability
Command: npx skills add https://github.com/shotcowboystyle/meta-wearables-ops-plugin --skill meta-wearables-debugging-observability-shotcowboystyle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Meta Wearables DAT integrations fail across many layers — registration, permissions, device link, sessions, camera, audio, Display, and transport — and generic "not connected" errors make it hard to tell whether the fault lies in app code, the Meta AI companion boundary, firmware, or the release channel. This Skill provides a structured, read-only diagnostic workflow that isolates the first failing state and produces a redacted evidence packet. ## Core Features & Use Cases - First-failure isolation: Walks the boundary from debug-server connection through SDK readiness, registration, permissions, device link, session, and capability to identify the earliest blocking state. - Live MCP diagnostics: Uses DAT Inspector tools such as get_connection_status, get_sdk_state, get_dat_readiness, wait_for_events, and export_diagnostic_bundle when a local debug server is available. - Redacted handoff packets: Exports and sanitizes diagnostic bundles, removing credentials, tokens, raw media, and device identifiers before sharing. - Use Case: Your Android DAT app cannot start a camera stream on glasses. Use this Skill to freeze the target tuple, check readiness and companion-boundary state, reproduce one narrow operation, and return a bounded conclusion naming the likely owner and the proof still missing. ## Quick Start Diagnose why my Meta Wearables DAT app fails to start a camera stream on connected glasses and produce a redacted diagnostic handoff.

Frequently Asked Questions about meta-wearables-debugging-observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Meta Wearables DAT app that cannot connect to glasses?

Start by connecting to the local DAT Inspector debug server and checking get_connection_status, get_sdk_state, and get_dat_readiness in that order. Connection failure, SDK failure, and device-link failure are distinct states, so identify the first failing transition before attempting recovery.

How do I use the DAT Inspector MCP tools for live debugging?

Discover and connect to the local debug server, establish readiness with get_dat_readiness, then reproduce one narrow operation while capturing wait_for_events with the narrowest category. Use get_errors or get_event_digest for the digest and export_diagnostic_bundle for a redacted handoff.

Does Meta Wearables debugging work on both iOS and Android?

Yes, the workflow covers both platforms with platform-specific anchors such as Wearables.configure() on iOS and Wearables.initialize(context) on Android. Each platform uses its own typed results and errors, and symbols should not be translated across platforms.

What data should be redacted from a DAT diagnostic bundle?

Remove credentials, client and access tokens, raw image, video, and audio, transcripts, personal data, precise device identifiers, and account emails. Keep state names, timestamps, SDK revisions, error categories, and counters needed for diagnosis, and replace identifiers with stable local labels.

Why does my DAT app show a generic not connected error?

A generic not connected message hides the actual first failing state, which could be registration, permission, device eligibility, link, session, or transport. Walk the boundary in order using readiness and companion-boundary diagnosis tools to observe the exact failing transition instead of guessing.

Can debugging mutate the Meta AI app or glasses state?

No, diagnosis is strictly read-only and must not mutate Meta AI, glasses, account, permission, registration, project, or release-channel state unless the user separately authorizes that operation. The workflow treats debugging as observation, not intervention.