Skip to content

fix: remove unsupported frontmatter attributes from SKILL.md#50

Open
luckyjc wants to merge 1 commit intocoleam00:mainfrom
luckyjc:fix/remove-unsupported-skill-attributes
Open

fix: remove unsupported frontmatter attributes from SKILL.md#50
luckyjc wants to merge 1 commit intocoleam00:mainfrom
luckyjc:fix/remove-unsupported-skill-attributes

Conversation

@luckyjc
Copy link

@luckyjc luckyjc commented Feb 9, 2026

Remove 'argument-hint' and 'disable-model-invocation' from the skill frontmatter as they are not supported attributes. Claude Code skill files only support: name, description, compatibility, license, and metadata.

Arguments are still passed via $ARGUMENTS and work without argument-hint.

Big fan of your content, thanks for putting this together! 🙌

Remove 'argument-hint' and 'disable-model-invocation' from the skill
frontmatter as they are not supported attributes. Claude Code skill files
only support: name, description, compatibility, license, and metadata.

Arguments are still passed via $ARGUMENTS and work without argument-hint.
Copy link

@joel joel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, this is not true:

The official documentation says: https://code.claude.com/docs/en/skills#frontmatter-reference

Here's the complete list from the official Claude Code docs:

Field Required Description
name No Display name for the skill. Uses directory name if omitted. Lowercase letters, numbers, hyphens only (max 64 chars).
description Recommended What the skill does and when to use it. Claude uses this for triggering decisions. Falls back to first markdown paragraph if omitted.
argument-hint No Hint shown during autocomplete for expected arguments (e.g., [issue-number] or [filename] [format]).
disable-model-invocation No Set to true to prevent Claude from auto-loading the skill. Use for manual /name workflows only. 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 in skills and agents for configuration format.

So 10 supported fields total, and none of them are strictly required (though description is strongly recommended).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants