Handling Validation Errors

What it does

This skill enhances the handling of validation errors generated by the z-schema library. It allows AI agents to inspect, filter, map, and present these errors in a user-friendly way. Specifically, it focuses on processing ValidateError objects, which contain detailed information about each individual error within the .details array. This skill enables graceful management of validation failures and provides actionable feedback based on schema validation results.

When to use it

• When validating data against a z-schema schema and needing to provide specific error messages to users or systems.
• In situations where you want to extract key information (like the error code, path, and message) from complex ValidateError objects.
• To create custom error reporting workflows based on the details contained within a z-schema validation failure.

Key capabilities

• Inspects ValidateError objects returned by z-schema.
• Accesses individual SchemaErrorDetail elements within the .details array of a ValidateError.
• Extracts specific error information such as: message, code, parameters, path, keyword, and schema details.
• Supports both "try/catch" (default) and "safe mode" for error handling.

Example prompts

• "Show me the paths of all validation errors."
• "Extract the error codes from this z-schema validation failure."
• "Format this ValidateError object into a human-readable report."

Tips & gotchas

• Requires the z-schema library to be installed and used for data validation.
• The skill works with both "try/catch" and "safe mode" error handling approaches offered by z-schema. Choose the appropriate method based on your application's needs.
• Error details are structured within a .details array, so iterating through this array is necessary to access individual error messages and information.