spine-server-handlers

Automate WebSocket JSON-RPC 2.0 endpoint creation and integration for Spine domains.

Updated Jan 6, 2026
One-click install
npx skills add https://github.com/cr8or-space/spine --skill spine-server-handlers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spine-server-handlers
Source: https://github.com/cr8or-space/spine/tree/main/.claude/skills/spine-server-handlers
Command: npx skills add https://github.com/cr8or-space/spine --skill spine-server-handlers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers need a consistent, scalable pattern for adding WebSocket JSON-RPC endpoints to Spine across multiple domains, with standardized validation, error handling, and session context management.

Core Features & Use Cases

  • Standardized handler naming and registration for domain operations like serial.bible.character.create and serial.structure.tree.
  • Structured request/response schemas and robust error handling using a shared RpcError framework and zod-based validation.
  • Session-aware context management to persist and reuse current project/structure state across requests.
  • Use Case: rapidly onboard new domain endpoints with predictable behavior and testability.

Quick Start

Implement a new domain endpoint by creating a typed handler with params and results, then register it during server startup.

Frequently Asked Questions about spine-server-handlers

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

FAQPage Schema
How do I create WebSocket JSON-RPC endpoints for Spine domains?

You create WebSocket JSON-RPC endpoints for Spine domains by building typed handlers with defined parameters and results, then registering them during server startup. This approach enforces standardized naming and predictable behavior across all domain operations.

How does zod schema validation work with WebSocket JSON-RPC 2.0 domain handlers?

Zod schema validation for WebSocket JSON-RPC 2.0 domain handlers works by enforcing structured request and response schemas for handler parameters and results. This standardizes validation across all Spine domain endpoints, ensuring predictable and testable behavior.

What is the best way to manage session context in WebSocket JSON-RPC servers?

The best way to manage session context in WebSocket JSON-RPC servers is using session-aware context management to persist and reuse current project or structure state across multiple requests. This maintains consistent state throughout client interactions.

How do I handle errors in WebSocket JSON-RPC domain handlers?

You handle errors in WebSocket JSON-RPC domain handlers by implementing a shared RpcError framework. This unified error scheme provides robust, structured error handling across all registered Spine domain endpoints.

Can I rapidly add new domain endpoints to a WebSocket JSON-RPC server without breaking existing behavior?

You can rapidly add new domain endpoints to a WebSocket JSON-RPC server without breaking existing behavior by applying standardized handler registration patterns. Typed schemas and a unified RpcError framework ensure new endpoints remain predictable and testable.

Why do I need standardized handler naming for WebSocket JSON-RPC domain operations?

Standardized handler naming for WebSocket JSON-RPC domain operations is needed to maintain consistency across multiple Spine domains. It enables rapid onboarding of new endpoints like character creation or structure tree operations with predictable routing.