plugin-review
Review plugin quality with tiered checks and dependency scoping. Use for PR and pre-release audits.
How do I install this agent skill?
npx skills add https://github.com/athola/claude-night-market --skill plugin-reviewIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill performs plugin quality audits by executing shell commands and scripts. It accesses git diffs and configuration files to determine scope. While it involves command execution and dynamic evaluation through other skills, these activities are aligned with its stated purpose as a review tool. A potential for indirect prompt injection exists because the skill processes external plugin code and configuration, though the risk is mitigated by its intended use in development environments.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/5 files flagged
What does this agent skill do?
Plugin Review
Overview
Tiered quality review of plugins with dependency-aware scoping.
When NOT To Use
- Reviewing one skill rather than a plugin (use
abstract:skills-eval) - Reviewing hooks (use
abstract:hooks-eval) - Tracing
Skill()references across plugins (useabstract:skill-graph-audit)
Tiers
| Tier | Trigger | Scope | Depth | Duration |
|---|---|---|---|---|
| branch | Default | Affected and related | Quick gates | ~2 min |
| pr | Before merge | Affected and related | Standard | ~5 min |
| release | Before version bump | Every plugin | Full | ~15 min |
Orchestration
- Detect scope: parse
--tierflag, find affected plugins from git diff, resolve related plugins fromdocs/plugin-dependencies.json - Plan: build check matrix (tier x plugin x role)
- Execute: run checks per tier definition
- Report: per-plugin table, aggregate verdict
Scope Detection
Affected plugins: git diff main --name-only filtered to
plugins/*/.
Related plugins: load docs/plugin-dependencies.json,
look up each affected plugin's reverse index to find
dependents. Mark as "related" (lighter checks).
If --tier release or no git diff available, scope to
all plugins.
Module Loading
- Always: this SKILL.md (orchestration logic)
- branch tier: load
modules/tier-branch.md - pr tier: load
modules/tier-branch.mdthenmodules/tier-pr.md - release tier: load all tier modules plus
modules/tier-release.md - When resolving deps: load
modules/dependency-detection.md
Verdict
| Result | Meaning |
|---|---|
| PASS | All checks green |
| PASS-WITH-WARNINGS | Non-blocking issues |
| FAIL | Blocking issues found |
Output Format
Plugin Review (<tier> tier)
Affected: <list>
Related: <list> (<reason>)
Plugin test lint type reg verdict
<name> PASS PASS PASS PASS PASS
...
Verdict: <PASS|PASS-WITH-WARNINGS|FAIL> (N/N plugins healthy)
PR and release tiers add scorecard sections.
Quality Gate Mode
The --quality-gate flag enables CI/CD integration with
exit codes that distinguish warnings from failures:
0: all quality gates passed1: warnings present but gates passed (non-blocking)2: quality gate failures (blocking)3: critical issues found (blocking)
Use --fail-on warning to treat warnings as blocking.
Configuration
Place a .plugin-review.yaml file in the plugin root
to customize thresholds and focus areas:
plugin_review:
quality_gates:
structure_min: 80
skills_min: 75
hooks_min: 70
tokens_max_total: 50000
bloat_max_percentage: 15
focus_areas:
- skills
- hooks
- tokens
exclude_patterns:
- "*/legacy/*"
- "*/deprecated/*"
severity_overrides:
missing_description: warning
large_file: info
See the /plugin-review command reference for full
usage examples.
Exit Criteria
- The output includes a per-plugin table with columns: test, lint, type, reg, verdict, and an aggregate PASS / PASS-WITH-WARNINGS / FAIL verdict.
- Scope detection identifies affected plugins via
git diff main --name-onlyfiltered toplugins/*/; if git diff is unavailable, the skill falls back to all-plugin scope and states this explicitly. - Any plugin scoring below the
structure_min(default 80) orskills_min(default 75) threshold is listed as a FAIL, not a warning. -
--quality-gatemode returns exit code 2 for blocking failures and exit code 1 for non-blocking warnings, distinguishable by the calling CI step.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/athola/claude-night-market/plugin-review">View plugin-review on skillZs</a>