Skip to main content
AI/MLjoaquimscosta

plugin-release-checker

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".

Stars
14
Source
joaquimscosta/arkhe-claude-plugins
Updated
2026-05-26
Slug
joaquimscosta--arkhe-claude-plugins--plugin-release-checker
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/joaquimscosta/arkhe-claude-plugins/HEAD/.claude/skills/plugin-release-checker/SKILL.md -o .claude/skills/plugin-release-checker.md

Drops the SKILL.md into .claude/skills/plugin-release-checker.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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