The YAML frontmatter controls how and when a skill runs. I'll go through the fields you'll use most:
name: the slug used for/nameinvocationdescription: Claude reads this to decide when to auto-invokeargument-hint: shown in the/menu (e.g."[issue-number]")disable-model-invocation: true: only you can invoke it, Claude never auto-triggers ituser-invocable: false: only Claude can invoke it, hidden from your/menuallowed-tools: restricts which tools Claude can use during this skillcontext: fork: runs the skill in an isolated subagentagent: which subagent type to use (Explore,Plan, or general-purpose)
The description field does double duty. Write it clearly so Claude knows when the skill is the right tool to reach for.