What happens if a breaking change is detected without a version bump?

The skill will return a failure status and exit code 1, providing a detailed error message suggesting the required version increase to maintain registry integrity.

How does it handle semantic versioning?

It follows semver principles and provides suggestions for major, minor, or patch increments based on the types of changes detected, such as removed fields or new features.

Does registry.diff identify security changes?

Yes, it specifically audits permission changes. It will flag added or removed permissions for manual review to prevent unauthorized access escalations.

What is the primary purpose of the registry.diff skill?

It compares current skill or agent manifests against a registry to detect changes in versions, permissions, and internal structure, ensuring consistency across updates.

Can I use registry.diff in my CI/CD pipeline?

Yes, the skill is designed for automation. It returns structured JSON and uses standard exit codes (0 for success, 1 for failure) to integrate with tools like GitHub Actions.

Registry Version Diff

Name: Registry Version Diff
Author: epieczko

byepieczko

0•

部署与 DevOps

Compares skill and agent manifests against the registry to ensure semantic versioning and prevent breaking changes.

The Registry Diff skill is an essential utility for developers working within the Betty framework to maintain the integrity of their skill and agent ecosystem. It automatically analyzes changes in manifest files, detecting version bumps, permission modifications, and potential breaking changes before they are officially registered. This tool is particularly useful for teams integrating automated validation into their CI/CD pipelines, as it provides structured JSON feedback and specific exit codes to block unauthorized or incompatible updates, ensuring a stable and secure development lifecycle for Claude Code extensions.

主要功能

01Automated semantic versioning validation (Major/Minor/Patch)

02Pre-commit and CI/CD pipeline compatibility with standard exit codes

03Integration-ready JSON output for programmatic workflows

04Breaking change detection for skill and agent manifests

05Permission auditing to track and flag security modifications

060 GitHub stars

使用场景

01Auditing permission changes during code reviews to ensure security compliance

02Performing pre-commit checks to ensure developers include required version bumps

03Validating skill manifests automatically during GitHub Actions CI runs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty registry.diff

For use in Claude.ai and ChatGPT

Download Skill