Design Serialization Schema
Design serialization schemas using JSON Schema, Protocol Buffer definitions, or Apache Avro. Covers schema versioning, backwards compatibility, validation rules, and evolution strategies for long-lived data formats. Use when defining a new API contract or data interchange format, adding fields to an existing schema without breaking consumers, migrating between schema versions, choosing between schema systems, or documenting data validation rules for automated enforcement.
Install
npx skills add pjt222/agent-almanac --skill design-serialization-schemagit clone --depth 1 https://github.com/pjt222/agent-almanac.git /tmp/agent-almanac
mkdir -p ~/.claude/skills
cp -r /tmp/agent-almanac/i18n/caveman-lite/skills/design-serialization-schema ~/.claude/skills/design-serialization-schemaPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Design Serialization Schema Create well-versioned serialization schemas that evolve gracefully without breaking consumers. ## When to Use - Defining a new API contract or data interchange format - Adding fields to an existing schema without breaking consumers - Migrating between schema versions - Choosing between schema systems (JSON Schema, Protobuf, Avro) - Documenting data validation rules for automated enforcement ## Inputs - **Required**: Data model (entity relationships, field types, constraints) - **Required**: Compatibility requirements (who consumes this data, how long must old formats be readable) - **Optional**: Existing schema to evolve - **Optional**: Performance requirements (validation speed, schema registry integration) - **Optional**: Target serialization format (JSON, binary, columnar) ## Procedure ### Step 1: Choose a Schema System | System | Format | Strengths | Best For | |---|---|---|---| | JSON Schema | JSON | Widely supported, flexible validation | REST APIs, config validation | | Protocol Buffers | Binary | Compact, fast, strong typing, built-in evolution | gRPC, microservices | | Apache Avro | Binary/JSON | Schema in data, excellent evolution support | Kafka, data pipelines | | XML Schema (XSD) | XML | Comprehensive typing, namespace support | Enterprise/legacy SOAP | | TypeBox/Zod | TypeScript | Type inference, runtime validation | TypeScript APIs |
Details
- Skill name
design-serialization-schema- Repository
- pjt222/agent-almanac
- Path
i18n/caveman-lite/skills/design-serialization-schema/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Design Serialization Schema skill do?
Design serialization schemas using JSON Schema, Protocol Buffer definitions, or Apache Avro. Covers schema versioning, backwards compatibility, validation rules, and evolution strategies for long-lived data formats. Use when defining a new API contract or data interchange format, adding fields to an existing schema without breaking consumers, migrating between schema versions, choosing between schema systems, or documenting data validation rules for automated enforcement.
How do I install the Design Serialization Schema skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add pjt222/agent-almanac --skill design-serialization-schema. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Design Serialization Schema popular?
It lives in pjt222/agent-almanac, which has 45 GitHub stars and 4 forks, and is included in 1 curated skill list.
Related skills
Adapt Architecture
45pjt222/agent-almanac
Execute structural metamorphosis using strangler fig migration, chrysalis phases, and interface preservation. Covers transformation planning, parallel running, progressive cutover, rollback design, and post-metamorphosis stabilization for system architecture evolution. Use when assess-form has classified the system as READY for transformation, when migrating from monolith to microservices, when replacing a core subsystem while dependents continue operating, or when any architectural change must be gradual rather than big-bang.
Adaptic
45pjt222/agent-almanac
Master skill composing the 5-step synoptic cycle for panoramic synthesis across multiple domains. Orchestrates meditate, expand-awareness, observe, awareness, integrate-gestalt, and express-insight into a coherent process that produces unified understanding rather than sequential compromise. Use when a problem genuinely spans 3+ domains and the interactions between domains matter more than depth in any one, when sequential analysis feels like compromise rather than integration, or before major architectural decisions affecting multiple stakeholders.
Add Puzzle Type
45pjt222/agent-almanac
Scaffold a new puzzle type across all 10+ pipeline integration points in jigsawR. Creates the core puzzle module, wires it into the unified pipeline (generation, positioning, rendering, adjacency), adds ggpuzzle geom/stat layers, updates DESCRIPTION and config.yml, extends the Shiny app, and creates a comprehensive test suite. Use when adding a completely new puzzle type to the package or following the 10-point integration checklist to ensure nothing is missed end-to-end.
Grade Tcg Card
45pjt222/agent-almanac
Grade a trading card using PSA, BGS, or CGC standards. Covers observation-first assessment (adapted from meditate's unbiased observation), centering measurement, surface analysis, edge and corner evaluation, and final grade assignment with confidence interval. Supports Pokemon, MTG, Flesh and Blood, and Kayou cards. Use when evaluating a card before professional grading submission, pre-screening a collection for high-grade candidates, settling condition disputes between buyers and sellers, or estimating the grade-dependent value spread for a card.
Define Slo Sli Sla
45pjt222/agent-almanac
Establish Service Level Objectives (SLO), Service Level Indicators (SLI), and Service Level Agreements (SLA) with error budget tracking, burn rate alerts, and automated reporting using Prometheus and tools like Sloth or Pyrra. Use when defining reliability targets for customer-facing services, balancing feature velocity against system reliability through error budgets, migrating from arbitrary uptime goals to data-driven metrics, or implementing Site Reliability Engineering practices.
Internal Investigation
43AlsKozlov/ru-legal
Backend framework для investigation suite — defines workspace structure, privilege protocols (РФ-specific!), interview templates, evidence chain of custody, дисциплинарные timing rules (ст.192-193 ТК). Sub-skill: вызывается из /investigation-open, -add, -query, -memo, -summary. Не user-invocable.
Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.