Agent skill
plugin-release-checker
Install this agent skill to your Project
npx add-skill https://github.com/joaquimscosta/arkhe-claude-plugins/tree/main/.claude/skills/plugin-release-checker
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
Skill Name
What this skill does. Use when user mentions "keyword1", "keyword2", or "keyword3". Keep under 1,024 characters and include specific trigger keywords.
skill-validator
Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories). Use when creating new skills, updating existing skills, before publishing skills, reviewing skill quality, or when user mentions "validate skill", "check skill", "skill best practices", "skill review", or "lint skill".
sync-docs
Sync official Anthropic documentation and analyze impact on project components. Runs docs/reference/update-claude-docs.sh, computes diffs, and reports impacts on the skill validator, plugins, and project documentation. Use when user mentions "sync docs", "update reference docs", "refresh docs", or "check doc changes".
research-frontmatter
Enforce standard YAML frontmatter on research documents in docs/research/. Use when creating, editing, or promoting research files, when user mentions "research metadata", "research frontmatter", or "research staleness".
deep-research
Deep research on technical topics using EXA tools with intelligent two-tier caching. Use when user asks to research a topic, investigate best practices, look up information, find patterns, or explore architectures. Also invoked by /research command. Triggers: "research", "look up", "investigate", "deep dive", "find information about", "what are best practices for", "how do others implement".
workflow-orchestration
Coordinate structured thinking and multi-agent parallel execution for complex tasks. Use when tackling multi-step projects, planning parallel work, breaking down complex problems, coordinating specialist tasks, facing architectural decisions, or when user mentions "workflow", "orchestration", "multi-step", "coordinate", "parallel execution", "structured thinking", "break this down", "plan this out", "how should I approach", or needs help planning complex implementations.
Didn't find tool you were looking for?