docs(skills): add disallowed-tools field and simplify bundled skill

- Bump version to v2.1.158
- Add disallowed-tools frontmatter field (15 -> 16): tools removed from the pool
  while skill is active, clears on next message
- Add simplify bundled skill (9 -> 10): cleanup-only review across four parallel
  agents; no longer hunts correctness bugs as of v2.1.154 (use /code-review)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-06-01 00:13:34 +05:00
parent 1455ed39dc
commit 951a06e497
+5 -3
View File
@@ -1,6 +1,6 @@
# Skills Best Practice # Skills Best Practice
![Last Updated](https://img.shields.io/badge/Last_Updated-May%2025%2C%202026%204%3A25%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.150-blue?style=flat&labelColor=555)<br> ![Last Updated](https://img.shields.io/badge/Last_Updated-Jun%2001%2C%202026%2012%3A01%20AM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.158-blue?style=flat&labelColor=555)<br>
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md) [![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md)
Claude Code skills — frontmatter fields and official bundled skills. Claude Code skills — frontmatter fields and official bundled skills.
@@ -14,7 +14,7 @@ Claude Code skills — frontmatter fields and official bundled skills.
--- ---
## Frontmatter Fields (15) ## Frontmatter Fields (16)
| Field | Type | Required | Description | | Field | Type | Required | Description |
|-------|------|----------|-------------| |-------|------|----------|-------------|
@@ -26,6 +26,7 @@ Claude Code skills — frontmatter fields and official bundled skills.
| `disable-model-invocation` | boolean | No | Set `true` to prevent Claude from automatically invoking this skill | | `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 | | `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 | | `allowed-tools` | string | No | Tools allowed without permission prompts when this skill is active |
| `disallowed-tools` | string/list | No | Tools removed from Claude's available pool while the skill is active (e.g. block `AskUserQuestion` for a background loop). Accepts a space/comma-separated string or YAML list — the restriction clears on the next message |
| `model` | string | No | Model to use when this skill runs (e.g., `haiku`, `sonnet`, `opus`) | | `model` | string | No | Model to use when this skill runs (e.g., `haiku`, `sonnet`, `opus`) |
| `effort` | string | No | Override the model effort level when invoked (`low`, `medium`, `high`, `xhigh`, `max`) | | `effort` | string | No | Override the model effort level when invoked (`low`, `medium`, `high`, `xhigh`, `max`) |
| `context` | string | No | Set to `fork` to run the skill in an isolated subagent context | | `context` | string | No | Set to `fork` to run the skill in an isolated subagent context |
@@ -36,7 +37,7 @@ Claude Code skills — frontmatter fields and official bundled skills.
--- ---
## ![Official](../!/tags/official.svg) **(9)** ## ![Official](../!/tags/official.svg) **(10)**
| # | Skill | Description | | # | Skill | Description |
|---|-------|-------------| |---|-------|-------------|
@@ -49,6 +50,7 @@ Claude Code skills — frontmatter fields and official bundled skills.
| 7 | `run` | Launch and drive the project's app to see a change working in the real app (not just tests). Requires v2.1.145 | | 7 | `run` | Launch and drive the project's app to see a change working in the real app (not just tests). Requires v2.1.145 |
| 8 | `verify` | Build and run the app to confirm a code change does what it should, without falling back to tests or type checks. Requires v2.1.145 | | 8 | `verify` | Build and run the app to confirm a code change does what it should, without falling back to tests or type checks. Requires v2.1.145 |
| 9 | `run-skill-generator` | Teaches `/run` and `/verify` how to build and launch the project — records a per-project launch recipe at `.claude/skills/run-<name>/`. Requires v2.1.145 | | 9 | `run-skill-generator` | Teaches `/run` and `/verify` how to build and launch the project — records a per-project launch recipe at `.claude/skills/run-<name>/`. Requires v2.1.145 |
| 10 | `simplify` | Review changed code for cleanup opportunities (reuse, simplification, efficiency, abstraction level), four review agents in parallel. From v2.1.154 it does **not** hunt for correctness bugs — use `/code-review` for that |
See also: [Official Skills Repository](https://github.com/anthropics/skills/tree/main/skills) for community-maintained installable skills. See also: [Official Skills Repository](https://github.com/anthropics/skills/tree/main/skills) for community-maintained installable skills.