skills.rest
ricardolui
ricardoluiCOMMUNITY
Explore all skills by this author →
GitHub

stale-expectations

Generate Schema Registry compatibility reports for Avro schemas in a project.

Updated Jul 7, 2026
Search Tags:#breaking changes#kafka#report#schema evolution#avro#compatibility check#schema registry
One-click install
npx skills add https://github.com/ricardolui/gcp-custom-agent-skills --skill stale-expectations-ricardolui
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stale-expectations
Source: https://github.com/ricardolui/gcp-custom-agent-skills/tree/main/confluent-skill-reviewer/evals/mock-skills/stale-expectations
Command: npx skills add https://github.com/ricardolui/gcp-custom-agent-skills --skill stale-expectations-ricardolui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams evolving Avro schemas risk deploying breaking changes that disrupt producers and consumers. This Skill checks local Avro schemas against the latest versions in Schema Registry and reports compatibility issues before they cause failures. ## Core Features & Use Cases - Avro Schema Discovery: Scans the project under src/main/avro/ to find all Avro schema files. - Registry Compatibility Checks: Queries the configured Schema Registry and runs compatibility/check for each schema against its latest registered version. - Severity-Grouped Reporting: Emits a Markdown report grouped by subject, classifying each change as breaking, warning, or safe. - Use Case: Before merging a schema change, run this Skill to confirm that adding or removing fields will not break existing consumers registered in Schema Registry. ## Quick Start Check the Avro schemas in this project for compatibility against Schema Registry and generate a report of any breaking changes.

Frequently Asked Questions about stale-expectations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Avro schema compatibility against Schema Registry?▼

Scan the project for Avro files under src/main/avro/, then query the configured Schema Registry and run compatibility/check for each schema against its latest registered version. The result is a Markdown report grouped by subject with severity levels.

How to detect breaking changes in Avro schema evolution?▼

Compare each local Avro schema with the latest version in Schema Registry using the compatibility/check endpoint. Changes are classified as breaking, warning, or safe in the generated report so you can spot incompatible field removals or type changes.

Does this compatibility check work for Protobuf or JSON Schema?▼

No. This Skill is scoped strictly to Avro schemas. It does not trigger for Protobuf, JSON Schema, or Kafka client code generation tasks, so use a different approach for those formats.

Where does the skill look for Avro schema files?▼

It discovers Avro files under the src/main/avro/ directory of the project. Schemas located elsewhere will not be picked up unless they are placed under that path.

What does the Avro compatibility report contain?▼

The report is a Markdown document grouped by Schema Registry subject. Each entry is labeled with a severity of breaking, warning, or safe based on the compatibility/check result against the latest registered schema version.

Related Skills

Explore More Software Engineering Skills→
doanchienthangdevdoanchienthangdev
4

Schema Registry

Manage event schemas with Avro, Protobuf, and JSON Schema formats.

Community
Advanced
confluentincconfluentinc
42

developing-kafka-python-client

Create a Python Kafka client project with Schema Registry and JSON Schema validation.

Official
Intermediate
webdriveriowebdriverio
11

Global Conventions

Validate code against global coding conventions for Claude Code projects.

Official
Basic
ROLLED740ROLLED740
1

springboot-verification

Automates Spring Boot build, static analysis, test coverage, security scan, and diff review for Maven/Gradle CI pipelines.

Community
Advanced