synapse-result-schemas

Provide Pydantic-based result schema classes for Synapse plugin actions.

1|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/datamaker-kr/synapse-claude-marketplace --skill synapse-result-schemas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synapse-result-schemas
Source: https://github.com/datamaker-kr/synapse-claude-marketplace/tree/main/plugins/synapse-plugin-helper/skills/result-schemas
Command: npx skills add https://github.com/datamaker-kr/synapse-claude-marketplace --skill synapse-result-schemas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that your Synapse plugin actions return data in a consistent, validated, and type-safe format, preventing errors and improving integration.

Core Features & Use Cases

  • Type-Safe Returns: Define expected output structures for actions like training, inference, export, and upload.
  • Automatic Validation: The Synapse SDK validates action return values against the defined schema, catching errors early.
  • Use Case: When building a custom training action, use TrainResult to ensure your action always returns the model weights path, final epoch, and relevant metrics in a predictable structure.

Quick Start

Use the synapse-result-schemas skill to understand how to define and use TrainResult for your custom training actions.

Frequently Asked Questions about synapse-result-schemas

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

FAQPage Schema
How do I standardize Synapse plugin action outputs for training and inference?

You can standardize Synapse plugin action outputs by using Pydantic-based result schema classes like TrainResult, which ensure type-safe and validated return values for training and inference actions. The SDK automatically validates these structures when you specify a result_model.

What are action result schemas in Synapse plugin development?

Action result schemas are standardized Pydantic classes that define expected output structures for Synapse plugin actions. They ensure that returned data for training, inference, export, upload, weights, and metrics is type-safe, validated, and consistently formatted.

Does Synapse SDK automatically validate custom action return values?

Yes, the Synapse SDK automatically validates custom action return values against the defined schema. When you specify a result_model in your class-based or function-based actions, the SDK catches errors early by checking the output against the Pydantic schema.

Can I use result schemas with function-based actions in Synapse?

Yes, you can use result schemas with both class-based and function-based actions in Synapse. By specifying a result_model, automatic result validation is applied to ensure your action returns data in a predictable and type-safe format.

What is the best way to define expected output structures for Synapse export and upload actions?

The best way to define expected output structures for Synapse export and upload actions is to use the provided Pydantic-based result schema classes. These schemas enforce type-safe returns and automatic validation, preventing integration errors and ensuring consistent data formats.