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