plugin-release-checker

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