diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md index ba4b3a8..0f42d64 100644 --- a/best-practice/claude-skills.md +++ b/best-practice/claude-skills.md @@ -1,6 +1,6 @@ # Skills Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Apr%2018%2C%202026%207%3A53%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.114-blue?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Apr%2024%2C%202026%2012%3A27%20AM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.118-blue?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md) Claude Code skills — frontmatter fields and official bundled skills. @@ -14,7 +14,7 @@ Claude Code skills — frontmatter fields and official bundled skills. --- -## Frontmatter Fields (14) +## Frontmatter Fields (15) | Field | Type | Required | Description | |-------|------|----------|-------------| @@ -22,6 +22,7 @@ Claude Code skills — frontmatter fields and official bundled skills. | `description` | string | Recommended | What the skill does. Shown in autocomplete and used by Claude for auto-discovery | | `when_to_use` | string | No | Additional context for when Claude should invoke the skill — trigger phrases and example requests. Appended to `description` in the skill listing, counts toward the 1,536-character cap | | `argument-hint` | string | No | Hint shown during autocomplete (e.g., `[issue-number]`, `[filename]`) | +| `arguments` | string/list | No | Named positional arguments for `$name` substitution in the skill content. Accepts a space-separated string or a YAML list — names map to argument positions in order | | `disable-model-invocation` | boolean | No | Set `true` to prevent Claude from automatically invoking this skill | | `user-invocable` | boolean | No | Set `false` to hide from the `/` menu — skill becomes background knowledge only, intended for agent preloading | | `allowed-tools` | string | No | Tools allowed without permission prompts when this skill is active |