Skill Schema V2

This is the compatibility entrypoint for the v2 skill schema. The installable v2 package is in skill-schema-v2.skill/.

Use it when a user is designing, auditing, refactoring, or repairing an Agent Skill.

Core Rule

A skill has three surfaces:

Routing Surface: name + description + frontmatter
Contract Surface: goal + inputs + permissions + evidence + output + verification + handoff
Runtime Boundary Surface: docs + examples + scripts + operators + fallback paths

The three surfaces must be aligned. If the description routes one task, the contract must govern that task, and runtime resources must support that task without forcing irrelevant context into the model.

What Changed in v2