Skip to content
Skills Library
AI & agents · Review & audit

plugin-review

/plugin-review

Review plugin quality with tiered checks and dependency scoping. Use for PR and pre-release audits.

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

  1. Overview
  2. When NOT To Use
  3. Tiers
  4. Orchestration
  5. Scope Detection
  6. Module Loading
  7. Verdict
  8. Output Format
  9. Quality Gate Mode
  10. 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

RepositoryScoreLicence
This page · athola/claude-night-market100MIT
whchoi98/aws-blog-skills100MIT
base/base-skills100MIT

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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.