Skills for Real Engineers. Straight from my .agents directory.
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
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)
1> **Plugin check**: Run `node "${PLUGIN_ROOT}/scripts/check-version.js"` - if it outputs a message, show it to the user before proceeding.23**📋 Shared instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** — read first.45Startup diagnosis uses the targeted compatibility inspection below instead of6the shared blanket version check; missing dependencies must not prevent diagnosis.7It does not check for updates. Explicit startup repair/restart approval overrides8shared auto-proceed/default-answer guidance.910# Debug App — Monitor & Fix1112Monitor 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.1314When setup/startup or device opening is failing, first execute15[startup-diagnostics.md](references/startup-diagnostics.md). This bounded phase16can run without Metro logs or a loaded app and returns to the runtime path only17…
Excerpt shown under the repository's MIT license.
More skills in power-platform-skills
Similar skill repositories
An agentic skills framework & software development methodology that works.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Production-grade engineering skills for AI coding agents.
The open-source app everyone uses to manage agents at work
