| name | plugin-release-checker |
| description | 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 user mentions "release check", "pre-release", "plugin-release-checker", or "release validation". |
| argument-hint | [--plugin <name>] [--all] |
Plugin Release Checker
Pre-release content quality gate that complements scripts/release.sh. Run before generating the changelog or triggering the release workflow.
Quick Start
Run the validation script to check all plugins:
scripts/check_release_readiness.py --all
Check a specific plugin:
scripts/check_release_readiness.py --plugin core
Release Workflow Integration
/plugin-release-checker ← THIS: validates plugin content quality
↓ (all checks pass)
/changelog ← generates CHANGELOG entry
↓
./scripts/release.sh X.Y.Z ← handles git tag + GitHub Release
Checks Performed
| Check | Description |
|---|
| Skill Validation | Run skill-validator across all skills in each plugin |
| Marketplace Sync | Verify all plugins in plugins/ have entries in marketplace.json |
| Version Consistency | Check plugin.json versions match CHANGELOG entries |
| Cross-References | Detect broken links in SKILL.md → WORKFLOW.md, EXAMPLES.md, etc. |
| Required Files | Ensure each plugin has plugin.json and README.md |
| Frontmatter | Validate YAML frontmatter in agents, commands, and skills |
Output
=== Plugin Release Readiness Report ===
Plugin: core (v2.0.0)
✓ All skills pass validation
✓ Marketplace entry found
✓ Version consistent with CHANGELOG
✓ No broken cross-references
Plugin: git (v1.0.0)
✗ Skill 'creating-commit': 1 error (SS002: SKILL.md exceeds 500 lines)
✓ Marketplace entry found
✓ Version consistent with CHANGELOG
✓ No broken cross-references
Summary: 9/10 plugins ready, 1 plugin has issues
Command Options
--all
--plugin NAME
--skip-skill-validator
--format {text,json}
