Design Serialization Schema
Skill ActiveDesign 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.
Design robust and evolvable serialization schemas for APIs and data interchange formats, ensuring compatibility and maintainability.
Features
- Schema system selection guidance (JSON Schema, Protobuf, Avro)
- Detailed schema evolution planning and compatibility rules
- Implementation examples for validation (Python, TypeScript)
- Best practices for schema versioning and changelogs
- Guidance on documenting schemas for automated enforcement
Use Cases
- Defining new API contracts or data interchange formats.
- Adding fields to existing schemas without breaking consumers.
- Migrating between different schema versions.
- Choosing the most suitable schema system for a project.
Non-Goals
- Performing the actual serialization/deserialization of data.
- Managing schema registries directly.
- Generating code from schemas (though it guides the design for it).
Trust
- warning:Issues AttentionIn the last 90 days, 9 issues were opened and 195 were closed. The closure rate is approximately 68.4%, which is adequate, but the high number of open issues relative to closed issues might indicate slower responsiveness for new problems.
Installation
/plugin install agent-almanac@pjt222-agent-almanacQuality Score
Trust Signals
Similar Extensions
Graphql Schema
98Guide for designing GraphQL schemas following industry best practices. Use this skill when: (1) designing a new GraphQL schema or API, (2) reviewing existing schema for improvements, (3) deciding on type structures or nullability, (4) implementing pagination or error patterns, (5) ensuring security in schema design.
Database Designer
98Use when the user asks to design database schemas, plan data migrations, optimize queries, choose between SQL and NoSQL, or model data relationships.
System Design
79Design systems, services, and architectures. Trigger with "design a system for", "how should we architect", "system design for", "what's the right architecture for", or when the user needs help with API design, data modeling, or service boundaries.
Sdk Dx
100Design SDKs that developers love to use—APIs that feel native, error messages that guide, and experiences that reduce friction. This skill covers creating SDKs that drive adoption through exceptional developer experience rather than aggressive marketing. Trigger phrases: "SDK design", "developer experience", "API design", "SDK DX", "error messages", "type safety", "IDE integration", "SDK versioning", "migration guides", "client library design", "making SDKs feel native", "SDK best practices"
Validate Plugin
100Validate a Claude Code plugin structure, frontmatter, and MCP tool references
Migrate Validate
100Validate pending migrations for foreign key consistency, rollback safety, and best practices