storage-variant-guide

Guide for implementing features across all storage variants. Use when the user is adding or modifying storage layer functionality.

Jump to install

Repository: Apicurio/apicurio-registry
Last source activity: March 26, 2026 at 13:13
Detected SKILL.md language: English
Stars: 912
Forks: 606

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Apicurio/apicurio-registry --skill storage-variant-guide

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

sdk-update

Guide for updating SDKs when REST API changes are made. Use when the user modifies REST API endpoints, request/response models, or the OpenAPI spec.

2026-03-26

security-review

Security review checklist. Use when the conversation involves authentication, authorization, OIDC, secrets, or TLS configuration changes.

2026-03-26

View all from this repository

name	storage-variant-guide
description	Guide for implementing features across all storage variants. Use when the user is adding or modifying storage layer functionality.
allowed-tools	Read, Grep, Glob

Storage Variant Implementation Guide

When implementing a feature that touches the storage layer:

Start with SQL (app/src/.../storage/impl/sql/) — this is the canonical implementation
Adapt for KafkaSQL (app/src/.../storage/impl/kafkasql/) — uses a Kafka journal pattern; state changes are serialized as Kafka messages and replayed
Consider GitOps (app/src/.../storage/impl/gitops/) — file-based, git-backed
Consider KubernetesOps (app/src/.../storage/impl/kubernetesops/) — ConfigMap-based
Update RegistryStorage interface if adding new operations
Update decorators (storage/decorator/) if the feature needs cross-cutting behavior
DTOs must be serializable — KafkaSQL journals serialize them
Test with at least SQL and KafkaSQL integration test profiles

storage-variant-guide

Source facts

Install options

Review the source files

More from this repository

More from this repository

Storage Variant Implementation Guide

Storage Variant Implementation Guide