$schema: https://json-schema.org/draft/2020-12/schema
title: Skill frontmatter
type: object
properties:
  name:
    description: Display name of the skill. Must match the skill's directory name.
    type:
    - string
    - 'null'
  description:
    description: Short summary of what the skill does. Required.
    type: string
  license:
    description: License identifier for the skill.
    type:
    - string
    - 'null'
  compatibility:
    description: Compatibility information for the skill.
    type:
    - string
    - 'null'
  metadata:
    description: Free-form metadata as key-value pairs.
    type:
    - object
    - 'null'
    additionalProperties:
      type: string
  polytoken:
    anyOf:
    - const: true
    - $ref: '#/$defs/SkillPolytokenFrontMatter'
required:
- description
$defs:
  SkillPolytokenFrontMatter:
    description: Polytoken-specific skill controls.
    type: object
    properties:
      disable_model_invocation:
        description: |-
          When true, the model cannot invoke this skill on its own; only explicit
          references load it.
        type:
        - boolean
        - 'null'
      tags:
        description: Tags that group this skill for `tag!` references.
        type:
        - array
        - 'null'
        items:
          type: string