yao-meta-skill/references/packaging-contracts.md

Packaging Contracts

cross_packager.py is not just an export helper. It defines and validates platform contracts.

Current Targets

• openai
• claude
• generic

Contract Shape

Each target contract defines:

• required output fields
• required output files
• field mapping from the neutral source metadata

Failure Handling

When --expectations is provided:

• missing required files cause exit code 2
• missing required fields cause exit code 2
• validation failures are emitted in the JSON report

Source Of Truth

The neutral source remains:

• SKILL.md
• agents/interface.yaml

Target-specific metadata is generated at packaging time.