CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debug-app

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.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-validated operational manual with copy-paste-ready scripts, exact state formats, and a tightly sequenced workflow with genuine feedback loops. Its weaknesses are token efficiency and structure: the ~1170-line body restates core prohibitions many times over and inlines recipe catalogs, diagnostic string lists, and parity notes that belong in the references directory alongside startup-diagnostics.md.

Suggestions

Move the D3.1 bundle/transform recipe table, the D3.2 best-effort procedure, and the host-diagnostic string catalog into reference files (e.g., references/bundle-fix-recipes.md, references/host-diagnostics.md), keeping only the dispatch decision points inline in SKILL.md.

State the first-party native package boundary rule once in Constraints and cross-reference it from D2, D3.1, and D3.2 instead of restating the full prohibition list at each point.

Move the upstream parity table and the Notes section into a reference file; they are context for maintainers, not runtime guidance the executing agent needs in every invocation.

DimensionReasoningScore

Conciseness

Nearly all content is non-obvious, project-specific operational detail rather than concepts Claude already knows, but the body runs ~1170 lines with clear duplication that could be tightened: the first-party native package prohibition is restated roughly six times (Core Principles, D2 gate, D3 routing, D3.1 precheck, D3.2 constraints, Constraints), and the host-diagnostic string catalog appears in both the Dev-client limitation note and Step A's interpretation rule. This is more than minor trimming (not 4) yet the verbosity is contextual restatement of dense actionable material rather than padded explanation (not 2).

3 / 5

Actionability

Fully executable throughout — copy-paste-ready bash and inline Node scripts (the cursored tail reader, liveness probes, the redaction verifier invocation), exact JSON state schemas (metro-cursor.json, health.json), concrete pattern→action routing tables (Step B, D3, D3.1), an exact console.log injection format with a cleanup grep key, and literal output templates for every exit path.

5 / 5

Workflow Clarity

The multi-phase workflow (Phase 0 preflight/discovery/baseline → Phase 0.5 symptom walk → monitor loop Steps A–D) is clearly sequenced with explicit validation checkpoints and feedback loops: type-check gate before advancing, re-poll fix verification, the supersession check before editing code, escalation after 2 failed attempts, the 50-cycle iteration cap, and verified cleanup of injected traces before any exit.

5 / 5

Progressive Disclosure

The single bundle reference (references/startup-diagnostics.md) is real, clearly signaled, and linked at exactly the right dispatch points, but the SKILL.md itself inlines hundreds of lines that belong in separate reference files — the D3.1 bundle-recipe catalog, the D3.2 best-effort procedure, the host-diagnostic string lists, the Failure Modes table, and the upstream parity table. Structure and signaling are better than the 2-anchor's 'minimal structure', but the volume of inlined detail that should be split out exceeds the 4-anchor's 'minor organization gaps'.

3 / 5

Total

16

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, highly specific description that names the domain (Power Apps mobile debugging), concrete capabilities, and approval boundaries in third person. The 'when' guidance is present via conditional phrasing rather than an explicit 'Use when…' clause, and a few natural trigger synonyms are missing, which keeps completeness and trigger-term quality just below the top anchors.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions with comprehensive domain coverage — "Diagnose Power Apps mobile install/startup failures, npm run dev errors, missing package entry points, or QR/device-opening problems", "monitor sanitized project-local Metro logs and diagnose runtime errors or silent failures such as empty lists and blank screens", and "Verify the original symptom, not merely installation or quiet logs" — all in third person.

5 / 5

Completeness

Clearly answers "what" (diagnose startup failures, monitor Metro logs, diagnose runtime errors and silent failures) and provides explicit conditional trigger guidance ("even before an app is loaded", "For a running native app"), but there is no direct "Use when…" clause and the when-guidance could be more explicit. This matches the anchor where both are present but 'when' could be more specific rather than the 3-anchor (what-only) or 5-anchor (concrete 'Use when' trigger phrases).

4 / 5

Trigger Term Quality

Good keyword coverage with natural user phrasings ("npm run dev errors", "QR/device-opening problems", "empty lists and blank screens", "silent failures", "startup failures"), but common variations users would say are missing (e.g., "app won't start", "crash", "fix", "debug"). Not score 3 because the included terms are natural and varied; not 5 because synonym coverage is incomplete.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers — "Power Apps mobile", "project-local Metro logs", "MSAL", "port/platform filters" — that no generic debugging skill would share; minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1178 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 missing, 3 deeper-than-1-level, 1 suspicious

Warning

Total

12

/

16

Passed

Repository

microsoft/power-platform-skills

Path

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

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.