Arkhe-claude-plugins 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".

install

source · Clone the upstream repo

git clone https://github.com/joaquimscosta/arkhe-claude-plugins

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/joaquimscosta/arkhe-claude-plugins "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/plugin-release-checker" ~/.claude/skills/joaquimscosta-arkhe-claude-plugins-plugin-release-checker && rm -rf "$T"

manifest: .claude/skills/plugin-release-checker/SKILL.md

source content

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