github-code/claude-howto
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: sync to Claude Code v2.1.126 (six new releases since April 27) (#111)

Browse Source 
Bumps tutorial coverage from v2.1.119 → v2.1.126 (May 1, 2026 release).
v2.1.120 was rolled back on its first release day (2026-04-24) but
re-released 2026-04-28 with regressions fixed; v2.1.124/125 skipped.

New feature documentation:
- claude project purge (v2.1.126) — 10-cli
- claude plugin prune / --prune (v2.1.121) — 07-plugins, 10-cli
- claude ultrareview [target] (v2.1.120) — 10-cli
- ${CLAUDE_EFFORT} placeholder + type-to-filter /skills (v2.1.120-121) — 03-skills
- alwaysLoad MCP server config option (v2.1.121) — 05-mcp
- PostToolUse.updatedToolOutput for non-MCP tools (v2.1.121) — 06-hooks
- ANTHROPIC_BEDROCK_SERVICE_TIER, AI_AGENT env vars — 10-cli
- --dangerously-skip-permissions extended path coverage — 09-advanced-features
- Windows PowerShell-as-primary-shell + /model gateway discovery (v2.1.126)
- OAuth code paste fallback (v2.1.126) — 10-cli

Fixes:
- xhigh missing from 03-skills effort enum (regression from April 24)
- README.md latest-version claims (lines 105, 204) and version badge
- CHANGELOG.md v2.4.0 stale "v2.1.120 was rolled back" paragraph

Footer refresh: 22 in-scope English files bumped to May 2, 2026 / 2.1.126.
Localized vi/zh/uk/ja trees out of scope (community-maintained).
This commit is contained in:
Luong NGUYEN
2026-05-03 00:07:51 +02:00
committed by GitHub
parent c78305971e
commit 0f8012c36e
22 changed files with 216 additions and 64 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
03-skills/README.md
View File

@@ -150,7 +150,7 @@ disable-model-invocation: true # Only user can invoke
user-invocable: false # Hide from slash menu
allowed-tools: Read, Grep, Glob # Restrict tool access
model: opus # Specific model to use
effort: high # Effort level override (low, medium, high, max)
effort: high # Effort level override (low, medium, high, xhigh, max)
context: fork # Run in isolated subagent
agent: Explore # Which agent type (with context: fork)
shell: bash # Shell for commands: bash (default) or powershell
@@ -173,7 +173,7 @@ paths: "src/api/**/*.ts" # Glob patterns limiting when skill activ
| `user-invocable` | `false` = hidden from the `/` menu. Only Claude can invoke it automatically. |
| `allowed-tools` | Comma-separated list of tools the skill may use without permission prompts. |
| `model` | Model override while the skill is active (e.g., `opus`, `sonnet`). |
| `effort` | Effort level override while the skill is active: `low`, `medium`, `high`, or `max`. |
| `effort` | Effort level override while the skill is active: `low`, `medium`, `high`, `xhigh`, or `max`. Available levels depend on the model — `xhigh` is the Claude Code default for Opus 4.7. |
| `context` | `fork` to run the skill in a forked subagent context with its own context window. |
| `agent` | Subagent type when `context: fork` (e.g., `Explore`, `Plan`, `general-purpose`). |
| `shell` | Shell used for `!`command`` substitutions and scripts: `bash` (default) or `powershell`. |
@@ -242,6 +242,7 @@ Skills support dynamic values that are resolved before the skill content reaches
| `$ARGUMENTS[N]` or `$N` | Access specific argument by index (0-based) |
| `${CLAUDE_SESSION_ID}` | Current session ID |
| `${CLAUDE_SKILL_DIR}` | Directory containing the skill's SKILL.md file |
| `${CLAUDE_EFFORT}` | Current effort level (`low`, `medium`, `high`, `xhigh`, or `max`). Useful for branching skill behavior: e.g., `[ "${CLAUDE_EFFORT}" = "max" ] && deep_analysis` (v2.1.120+) |
| `` !`command` `` | Dynamic context injection — runs a shell command and inlines the output |
**Example:**
@@ -598,6 +599,8 @@ ls ~/.claude/skills/
ls .claude/skills/
```
> **Tip (v2.1.121+):** Type to filter the `/skills` interactive menu — useful when many skills are installed.
### Testing a Skill
Two ways to test:
@@ -820,8 +823,8 @@ Once you start building skills seriously, two things become essential: a library
- [Hooks Guide](../06-hooks/) - Event-driven automation
---
**Last Updated**: April 24, 2026
**Claude Code Version**: 2.1.119
**Last Updated**: May 2, 2026
**Claude Code Version**: 2.1.126
**Sources**:
- https://code.claude.com/docs/en/skills
- https://code.claude.com/docs/en/settings