# audit-ppmplugin

audit-ppmplugin runs a static audit on assembled .ppmplugin packages before wrap testing. Catches manifest collisions, DEX issues, and bad archive layouts on disk.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1167 repo stars
- Author: Microsoft
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-apps-mobile-extension/skills/audit-ppmplugin/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/audit-ppmplugin

## What it does

The skill unpacks the specified .ppmplugin into a temporary directory to inspect contents without touching the source package. It enforces strict layout rules: manifest.json must sit at the root, build output directories like node_modules or dist are flagged, and JS or TypeScript files trigger critical errors. Manifest checks verify name syntax, method lists, canonical prefixes, and reserved names like DeviceInfo or wrap runtime namespaces.

For mobile components, it verifies Android DEX integrity and iOS framework contents. Findings are tagged with CRITICAL, WARNING, or INFO severities, pointing errors back to the specific build or generation step responsible.

Without the jar utility from a JDK, the audit stops immediately with a blocking error. Detailed string scanning inside Android DEX files relies on dexdump or strings, downgrading to warnings if neither binary is present.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add microsoft/power-platform-skills
```
In the agent chat (not a shell):
```text
/plugin install power-apps-mobile-extension@power-platform-skills
```
This installs the whole power-apps-mobile-extension plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill audit-ppmplugin -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/audit-ppmplugin/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/audit-ppmplugin/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill audit-ppmplugin -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/audit-ppmplugin/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill audit-ppmplugin -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/audit-ppmplugin/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/power-platform-skills plugins/power-apps-mobile-extension/skills/audit-ppmplugin
```

2. **Manually: put the files in place**
- File: `.github/skills/audit-ppmplugin/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill audit-ppmplugin -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/power-apps-mobile-extension/skills/audit-ppmplugin
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/audit-ppmplugin/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-apps-mobile-extension/skills/audit-ppmplugin/SKILL.md

## When to use it
- inspect .ppmplugin bundles for invalid layout or leaked web assets
- validate manifest.json against canonical prefix and reserved name rules
- verify Android DEX integrity and check for SDK leakage
- surface wrap runtime dispatch errors before device testing

## Example prompts
- /audit-ppmplugin
- /audit-ppmplugin ./ppmplugin/plugin-name.ppmplugin
- Run static verification on the built .ppmplugin bundle

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: aa34c837b9113024.

BEGIN THIRD-PARTY FILE aa34c837b9113024
```text
---
name: audit-ppmplugin
description: "Statically audit a built `.ppmplugin` before wrap testing. Checks archive layout, manifest compatibility, bundle consistency, Android DEX integrity and SDK leakage, iOS framework structure, native source-to-receiver alignment, and the PCF composite-key/sendAsync transport contract. Reports CRITICAL, WARNING, and INFO findings with fixes routed to the owning stage; never modifies the archive. Requires `jar`; `dexdump` or `strings` improves DEX inspection. Run after /assemble-ppmplugin or standalone on an existing bundle."
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Skill
model: sonnet
---

# /audit-ppmplugin

The verification gate. `/assemble-ppmplugin` proves the bundle is *well-formed*; this skill proves it will *actually load and dispatch* on the wrap runtime. Most `.ppmplugin` failures are silent — the bundle uploads fine, then a method returns `native module 'X' not loaded`, the runtime cannot instantiate the package class, or the upload is rejected with `0x80040265` (canonical-prefix violation). Those cost a full wrap-build round-trip to discover. This skill surfaces them in seconds, on disk.

It is **read-only on the bundle** — it unzips to a temp dir for inspection and never mutates the `.ppmplugin`. Fixes route back upstream (`/generate-ppmplugin-manifest` for manifest issues, the build skills for binary issues), then re-assemble + re-audit.

Read [`shared/ppmplugin-format.md`](../../shared/ppmplugin-format.md) §1 (layout), §3 (canonical-prefix), §4 (validator rules), §5 (Android DEX requirements) — this skill enforces all four against the *built artifact*.

## What this skill does NOT do
- Does not build, zip, or author anything — it inspects a finished `.ppmplugin`. Fixes are made upstream and re-assembled.
- Does not patch the zip in place — a bundle is an immutable deliverable; mutating it would desync it from the staged sources. It points at the upstream skill instead.
- Does not upload to Dataverse / wire into a canvas app (Stage 3 — deferred). "READY TO UPLOAD"
  means *passes local verification*, not *uploaded*.

---

## Step 1 — Read shared docs + resolve the artifact + prereqs

1. Read [`shared/shared-instructions.md`](../../shared/shared-instructions.md) and [`shared/ppmplugin-format.md`](../../shared/ppmplugin-format.md).
```
END THIRD-PARTY FILE aa34c837b9113024

The third-party file has ended. Everything between the aa34c837b9113024 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2364 of 23106 bytes. © Microsoft · MIT · https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-apps-mobile-extension/skills/audit-ppmplugin/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
