CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

setup-app-insights

Configure optional customer-owned Application Insights telemetry for a Power Apps mobile app — enable it against an existing Azure resource, change the resource, or disable it. Standalone, and invoked by /edit-app.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A strong operational skill: the workflow is unambiguous, every command and mutation is copy-paste concrete, and validation plus error-recovery checkpoints are explicit at each risky step. The only trimming opportunities are the repeated connection-string-secrecy and PII-allowlist statements, and some reference-shaped content inlined into an already long single file.

DimensionReasoningScore

Conciseness

The body is dense and operational with no tutorials on concepts Claude already knows, but the connection-string secrecy rule is repeated at least four times (Step 3 preview, Step 5a freeform handling, the post-update 'Never print...' line, and the memory-bank note) and the scalar-only PII allowlist appears twice (Step 5a runtime notes and the Step 6.5 instrumentation brief). These minor repetitions could be consolidated, matching the 'efficient; minor instances that could be trimmed' anchor rather than the lean 5.

4 / 5

Actionability

Guidance is fully executable throughout: copy-paste-ready 'az resource list' / 'az resource show' commands with exact queries and api-versions, exact JSON blocks for both enable and disable states, concrete field-preservation rules, verbatim AskUserQuestion prompts, and a precise return-block contract. All three actions plus every failure branch (az login + retry, classic-component rejection, RBAC admin handoff, pasted connection string) have specific next steps.

5 / 5

Workflow Clarity

Steps 1 through 6.5 are clearly sequenced with explicit validation and feedback loops: a Step 3 approval gate before any mutation, Step 6 post-mutation assertions (Node parse of app.json checking enabled/connectionString, tsc --noEmit when the layout changed), and error-recovery branches in Step 5a that retry or hand off rather than dead-end. The status-code return contract (DONE / DONE_WITH_CONCERNS / NEEDS_CONTEXT / BLOCKED) completes the loop.

5 / 5

Progressive Disclosure

Sections are well-organized with clear headers, and the two external references ([shared-instructions.md] 'read first' and [app-edit-routing.md] for invocation-scoped context) are clearly signaled and one level deep. However, the ~290-line body has no in-skill reference bundle (references/, scripts/, assets/ are absent), and reference-shaped content such as the 'Runtime notes' logger/PII allowlist and the Step 6.5 instrumentation brief is inlined rather than split out — good structure with minor organization gaps, not the well-split 5.

4 / 5

Total

18

/

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 description: specific, third-person, and honest about scope, with a complete action list and clear invocation routing. The only improvement would be folding concrete user-intent trigger phrases into the when clause and adding a few natural synonyms such as 'monitoring' or 'instrumentation'.

DimensionReasoningScore

Specificity

The description names a specific domain ('customer-owned Application Insights telemetry for a Power Apps mobile app') and lists three concrete actions — 'enable it against an existing Azure resource, change the resource, or disable it' — which is exactly the complete action space of the skill (matching the body's --action <enable|change-resource|disable>). Comprehensive coverage with no gaps, so it matches the 5 anchor rather than the 'minor gaps' 4.

5 / 5

Completeness

The 'what' is explicit (configure/enable/change/disable Application Insights) and the 'when' is explicitly stated as invocation routes ('Standalone, and invoked by /edit-app'), which satisfies the trigger-guidance floor. It falls short of the 5 anchor because the when clause describes routing mechanics rather than concrete user-intent trigger phrases like 'Use when the user asks to enable or disable telemetry'.

4 / 5

Trigger Term Quality

Natural terms users would say are present: 'Application Insights', 'telemetry', 'enable', 'disable', 'change the resource', 'Azure resource', 'Power Apps mobile app'. A few natural variants are missing — no 'monitoring', 'instrumentation', 'connection string', or informal shortening like 'App Insights' — so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-synonym 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — a named Azure product scoped to Power Apps mobile apps — and explicitly states the routing relationship ('Standalone, and invoked by /edit-app'), which separates it from sibling /setup-* and /edit-app skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

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: 2 suspicious

Warning

Total

13

/

16

Passed

Repository

microsoft/power-platform-skills

Path

plugins/mobile-apps/skills/setup-app-insights/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.