Support new Claude Code skills as commands frontmatter scheme

Author: OrenMeCreated Jan 24, 2026Updated Aug 21, 2026

The new definition makes a lot of sense and should be adopted to the spec Almost all AI harnesses have some kind of commands or slash commands so this can be adopted easily See the article at https://x.com/trq212/status/2014836841846132761 And documentation at https://code.claude.com/docs/en/skills

New fields to consider: disable-model-invocation, model, context, agent

Field Required Description
name No Display name for the skill. If omitted, uses the directory name. Lowercase letters, numbers, and hyphens only (max 64 characters).
description Recommended What the skill does and when to use it. Claude uses this to decide when to apply the skill. If omitted, uses the first paragraph of markdown content.
argument-hint No Hint shown during autocomplete to indicate expected arguments. Example: [issue-number] or [filename] [format].
disable-model-invocation No Set to true to prevent Claude from automatically loading this skill. Use for workflows you want to trigger manually with /name. Default: false.
user-invocable No Set to false to hide from the / menu. Use for background knowledge users shouldn’t invoke directly. Default: true.
allowed-tools No Tools Claude can use without asking permission when this skill is active.
model No Model to use when this skill is active.
context No Set to fork to run in a forked subagent context.
agent No Which subagent type to use when context: fork is set.
hooks No Hooks scoped to this skill’s lifecycle. See Hooks for configuration format.

Field Required Description name No Display name for the skill. If omitted, uses the directory name. Lowercase letters, numbers, and hyphens only (max 64 characters). description Recommended What the skill does and when to use it. Claude uses this to decide when to apply the skill. If omitted, uses the first paragraph of markdown content. argument-hint No Hint shown during autocomplete to indicate expected arguments. Example: [issue-number] or [filename] [format]. disable-model-invocation No Set to true to prevent Claude from automatically loading this skill. Use for workflows you want to trigger manually with /name. Default: false. user-invocable No Set to false to hide from the / menu. Use for background knowledge users shouldn’t invoke directly. Default: true. allowed-tools No Tools Claude can use without asking permission when this skill is active. model No Model to use when this skill is active. context No Set to fork to run in a forked subagent context. agent No Which subagent type to use when context: fork is set. hooks No Hooks scoped to this skill’s lifecycle. See Hooks for configuration format.