| 1 | # Plugin Validator |
| 2 | |
| 3 | Validate Agent Zero plugins against structural, manifest, convention, and security expectations. |
| 4 | |
| 5 | ## What It Does |
| 6 | |
| 7 | This plugin generates a structured validation prompt for either a local plugin or an external source, runs the review in a temporary agent context, and returns a markdown report that checks whether a plugin follows Agent Zero plugin conventions. |
| 8 | |
| 9 | ## Main Behavior |
| 10 | |
| 11 | - **Source-aware validation** |
| 12 | - Supports validating a local plugin by name or a plugin fetched from a Git repository. |
| 13 | - **Checklist-based review** |
| 14 | - Loads validation criteria, status icons, and guidance text from plugin assets. |
| 15 | - **Temporary validation context** |
| 16 | - Creates a temporary agent context, runs the generated prompt, and cleans up the context and temporary chat afterward. |
| 17 | - **Operational guidance in prompt** |
| 18 | - Embeds source-specific handling instructions into the prompt, including cleanup rules for temporary validation directories. |
| 19 | |
| 20 | ## Key Files |
| 21 | |
| 22 | - **Validation runner** |
| 23 | - `api/plugin_validator_run.py` performs a synchronous validation and returns the report. |
| 24 | - **Prompt builder** |
| 25 | - `helpers/prompt.py` builds the validation prompt with source instructions, selected checks, and scoring guidance. |
| 26 | - **Additional APIs** |
| 27 | - `api/plugin_validator_prepare_zip.py` |
| 28 | - `api/plugin_validator_queue.py` |
| 29 | - `api/plugin_validator_start.py` |
| 30 | |
| 31 | ## Configuration Scope |
| 32 | |
| 33 | - **Settings sections**: none |
| 34 | - **Per-project config**: `false` |
| 35 | - **Per-agent config**: `false` |
| 36 | |
| 37 | ## Plugin Metadata |
| 38 | |
| 39 | - **Name**: `_plugin_validator` |
| 40 | - **Title**: `Plugin Validator` |
| 41 | - **Description**: Validate Agent Zero plugins against manifest, structure, code pattern, and security conventions. |