Tooluck logoTooluck
SKILL.md

debug-app

Agent skill frommicrosoft/power-platform-skills

Diagnose Power Apps mobile install/startup failures, npm run dev errors, missing package entry points, or QR/device-opening problems even before an app is loaded. Inspect locally first; restore locked dependencies or restart Metro only with explicit approval, never upgrade packages or patch host/MSAL source. For a running native app, monitor sanitized project-local Metro logs and diagnose runtime errors or silent failures such as empty lists and blank screens. Supports startup-only diagnosis, symptoms, port/platform filters, bounded monitoring, and non-mutating --no-fix mode. Verify the original symptom, not merely installation or quiet logs.

How to install debug-app

install debug-app
# install the power-platform-skills pack with the skills CLI
npx skills add microsoft/power-platform-skills

# or add only this skill to Claude Code: copy the folder

plugins/mobile-apps/skills/debug-app/

# into

~/.claude/skills/debug-app/ (all projects)

.claude/skills/debug-app/ (one project)

plugins/mobile-apps/skills/debug-app/SKILL.md

MITFull file
1> **Plugin check**: Run `node "${PLUGIN_ROOT}/scripts/check-version.js"` - if it outputs a message, show it to the user before proceeding.
2
3**📋 Shared instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** — read first.
4
5Startup diagnosis uses the targeted compatibility inspection below instead of
6the shared blanket version check; missing dependencies must not prevent diagnosis.
7It does not check for updates. Explicit startup repair/restart approval overrides
8shared auto-proceed/default-answer guidance.
9
10# Debug App — Monitor & Fix
11
12Monitor the running app through the project-local `.powernative/metro-logs/` files written by `metro.config.js`, detect runtime and bundle errors, and fix them autonomously by editing the affected files (or routing to the right skill when the fix belongs in a domain like Dataverse schema or auth registration). For silent failures, inject temporary `console.log` statements at data-path boundaries, read only newly appended log bytes, then clean the traces after the root cause is fixed. Modeled on the upstream `app-debugger.agent.md` pattern — foreground loop, bounded polling, configurable clean-check/timeout exits, and optional watch-only operation.
13
14When setup/startup or device opening is failing, first execute
15[startup-diagnostics.md](references/startup-diagnostics.md). This bounded phase
16can run without Metro logs or a loaded app and returns to the runtime path only
17…

Excerpt shown under the repository's MIT license.

More skills in power-platform-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates