Demonstrates all available skill frontmatter fields. Use when you need a reference for skill configuration, when learning about skill capabilities, or when creating new skills from scratch.
This skill demonstrates all available frontmatter fields for Claude Code skills.
Use this as a reference when creating new skills. All fields shown above are valid skill frontmatter options.
| Field | Type | Purpose | Constraints | Default |
| -------------------------- | ------- | -------------------------------- | ------------------------------- | --------------- |
| name | string | Display name | kebab-case, lowercase | directory name |
| description | string | When to load this skill | Must include trigger keywords | first paragraph |
| argument-hint | string | Autocomplete hint for / menu | Brief hint text | none |
| allowed-tools | string | Tools without permission prompts | Comma-separated tool names | none |
| model | string | Model when skill is active | sonnet, opus, haiku, or inherit | inherit |
| user-invocable | boolean | Show in / menu | true or false | true |
| disable-model-invocation | boolean | Prevent Claude auto-loading | true or false | false |
| hooks | object | Scoped hooks for skill lifecycle | Valid hook configuration object | none |
Note: The fields context and agent are deprecated and not documented in the official Skills reference as of January 2026.
Validate your skill using:
# Frontmatter and structure validation (checks token complexity, links, references)
uvx skilllint@latest check ./path/to/skill/SKILL.md
# Plugin validation (if skill is part of a plugin)
claude plugin validate ./path/to/plugin/
| Error | Cause | Fix |
| -------------------------------------- | ----------------------------- | -------------------------------- |
| allowed-tools must be string | Used YAML array format | Change to comma-separated string |
| model must be sonnet/opus/haiku | Invalid model name | Use valid model identifier |
| YAML array detected | Used - Tool1 format | Change to Tool1, Tool2 format |
| Skill body exceeds 500 lines | Skill is too large | Split into multiple skills |
| Internal link points to missing file | Referenced file doesn't exist | Create file or fix path |
| Description too short | Less than 20 characters | Add trigger keywords and context |
This skill is for demonstration purposes only. When creating real skills, include only the fields you need.
Skills can be located in:
~/.claude/skills/skill-name/SKILL.md - Available across all projects.claude/skills/skill-name/SKILL.md - Version controlled, team sharedplugins/plugin-name/skills/skill-name/SKILL.md - Bundled in a pluginSearch for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer