AI & agents · Review & audit
plugin-review
/plugin-review
Review plugin quality with tiered checks and dependency scoping. Use for PR and pre-release audits.
For whom
- Author
- athola ↗
- Repository
- claude-night-market ↗
- Licence
- MIT
- Last repository change
- 01.10.2026
Assessment and security
100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 5
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 01.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Review plugin quality with tiered checks and dependency scoping. Use for PR and pre-release audits.
Original author description
Review plugin quality with tiered checks and dependency scoping. Use for PR and pre-release audits.
How it works
- Overview
- When NOT To Use
- Tiers
- Orchestration
- Scope Detection
- Module Loading
- Verdict
- Output Format
- Quality Gate Mode
- Configuration
Original SKILL.md headings · 129 lines, 506 words
SKILL.md preview
---
name: plugin-review
description: 'Review plugin quality with tiered checks and dependency scoping. Use for PR and pre-release audits.'
alwaysApply: false
category: plugin-management
tags:
- review
- quality
- validation
- testing
- architecture
dependencies:
- skills-eval
- hooks-eval
- rules-eval
tools:
- validate_plugin.py
- skill_analyzer.py
progressive_loading: true
model_hint: standard
---
# 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 (use
`abstract: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 | All 17 plugins | Full | ~15 min |
## Orchestration
1. **Detect scope**: parse `--tier` flag, find affected
plugins from git diff, resolve related plugins from
`docs/plugin-dependencies.json`
2. **Plan**: build check matrix (tier x plugin x role)
3. **Execute**: run checks per tier definition
4. **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.md` then
`modules/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 passed
- `1`: 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:
```yaml
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-only` filtered to
`plugins/*/`; 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) or `skills_min` (default 75)
threshold is listed as a FAIL, not a warning.
- [ ] `--quality-gate` mode returns exit code 2 for blocking failures and exit code 1 for
non-blocking warnings, distinguishable by the calling CI step.
Files in this package (5)
- SKILL.md 4 KB
- modules/dependency-detection.md 1 KB
- modules/tier-branch.md 2 KB
- modules/tier-pr.md 2 KB
- modules/tier-release.md 3 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · athola/claude-night-market | 100 | MIT |
| whchoi98/aws-blog-skills | 100 | MIT |
| base/base-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version a3ff5f84868c (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100evaluate-plugin
Evaluate plugin quality. Use when user says \"evaluate plugin\", \"review plugin quality\", \"score my plugin\", \"check plugin\", \"rate plugin\". - 100evaluate-plugin-batch
Batch evaluate every skill in a plugin and produce a plugin-level report. Use when auditing an entire plugin's quality or validating before a release. - 95plugin-release-checker
Validate plugin content quality before release. Run skill-validator across plugins, verify marketplace.json completeness, check plugin.json version consistency, and detect broken documentation cross-references. Use when preparing a release, before running release.sh, or when… - 100meta-plugin-structure
Use when the user asks to ”create a plugin”, ”scaffold a plugin”, or ”understand plugin structure” for Claude Code. - 100optimize-plugin
This skill should be used when the user asks to "validate a plugin", "optimize plugin", "check plugin quality", "review plugin structure", or "run plugin optimizer". - 100plugin-builder
Use when hardening, converting, auditing, or pre-release checking a Codex plugin package by verifying manifest paths, bundled skills, hooks, MCP/app config, validation gates, and release blockers.