Skip to main content

audit-plugin

Audit a marketplace (or a single plugin) — run the shipping-hygiene sensor, structural checks (every catalog entry has a dir, every dir has a manifest, versions in sync), and the portability sweep. Reports findings and offers fixes. Use to validate a marketplace is healthy.

Source facts

Repository
bdfinst/plugin-builder
Last source activity
June 9, 2026 at 15:16
Detected SKILL.md language
English
Stars
0
Forks
0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
audit-plugin
description
Audit a marketplace (or a single plugin) — run the shipping-hygiene sensor, structural checks (every catalog entry has a dir, every dir has a manifest, versions in sync), and the portability sweep. Reports findings and offers fixes. Use to validate a marketplace is healthy.
user-invocable
true
# /audit-plugin `[name]` Audit the whole marketplace, or one plugin if `[name]` is given. ## Before you start Read `${CLAUDE_PLUGIN_ROOT}/knowledge/marketplace-conventions.md` (§3–§5). ## Procedure 1. **Hygiene sensor (§3).** Run `bats tests/repo`. This proves the four invariants: refs resolve, no plugin-escaping refs, hook commands resolve, no shipped test/build tooling. If `tests/repo/shipped_script_refs_test.bats` is missing, offer to install it from `${CLAUDE_PLUGIN_ROOT}/templates/tests/shipped_script_refs_test.bats`. 2. **Structural checks.** Run `bash scripts/structural-check.sh`: - every catalog entry maps to a `plugins/<name>/` with a `plugin.json` - every plugin dir is registered in the catalog - catalog `version` == manifest `version`, and `source.ref` == `<name>-v<version>` 3. **Portability sweep.** Run `bash scripts/portability-check.sh` (or invoke `/portability-check`): `shellcheck -x` + shebang verification over shipped + dev scripts. 4. **Report.** For each failure, name the file, the invariant it violates, and a concrete fix. If `[name]` was given, filter the report to that plugin. Offer to apply the fixes; only edit files after the user confirms (or proceed if the fix is mechanical and unambiguous, e.g. syncing a drifted version). Be a sensor, not a narrator: surface findings, propose fixes, then act.
View on GitHub