tomevault-io 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 # Check all plugins (default)
--plugin NAME # Check specific plugin
--skip-skill-validator # Skip skill-validator (faster, less thorough)
--format {text,json} # Output format
Converted and distributed by TomeVault — claim your Tome and manage your conversions.