gos-validate-handoff

To validate a handoff payload, provide the target skill and payload to the tool; it reads the target's SKILL.md frontmatter, checks required fields, verifies path existence, and returns a structured OK or BLOCKED result with remediation.

Schema validation for handoff payloads ensures that data transferred between Coordinator, Director, and Employee agent boundaries conforms to declared required fields and path existence rules, preventing malformed handoffs from propagating downstream.

You can check required fields and file paths by running the validation script against the target skill's SKILL.md frontmatter; it parses the YAML schema, validates required and optional fields, and performs path existence checks for declared fields.

Yes, you need the PyYAML dependency installed to parse the SKILL.md frontmatter, as the validation tool reads and interprets the YAML schema definitions to check required fields and path existence.

The best way to handle strict mode and extra fields is using this validation tool, which applies strict mode rules at agent boundaries and reports extras in a structured BLOCKED result with remediation guidance for fast debugging.

A handoff payload validation returns BLOCKED when required fields are missing, declared file paths do not exist, or extra fields are present while strict mode is enabled, with the structured result providing specific remediation steps.