[DOCS] Skills guide examples include unnecessary prompt-caching-2024-07-31 beta header
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://platform.claude.com/docs/en/build-with-claude/skills-guide
Section/Topic
Code examples throughout the Skills guide that include beta headers
Current Documentation
Multiple code examples include the prompt caching beta header:
``python betas=["code-execution-2025-08-25", "skills-2025-10-02", "prompt-caching-2024-07-31"], ``
``typescript betas: ['code-execution-2025-08-25', 'skills-2025-10-02', 'prompt-caching-2024-07-31'], ``
``bash -H "anthropic-beta: code-execution-2025-08-25,skills-2025-10-02,prompt-caching-2024-07-31" \ ``
What's Wrong or Missing?
The prompt-caching-2024-07-31 beta header is no longer needed. The prompt caching documentation explicitly states:
"Prompt caching is now generally available, so you no longer need the beta prefix."
The API release notes confirm:
"The 1-hour cache duration for prompt caching is now generally available. You can now use the extended cache TTL without a beta header."
Including this deprecated beta header in examples may confuse developers who wonder why it's present, or cause them to unnecessarily include it in their own code.
Suggested Improvement
Remove prompt-caching-2024-07-31 from all beta arrays in the Skills guide examples:
Before:
betas=["code-execution-2025-08-25", "skills-2025-10-02", "prompt-caching-2024-07-31"],
After:
betas=["code-execution-2025-08-25", "skills-2025-10-02"],
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://platform.claude.com/docs/en/build-with-claude/skills-guide | 1393, 1407 | Python examples |
| https://platform.claude.com/docs/en/build-with-claude/skills-guide | 1424, 1438 | TypeScript examples |
| https://platform.claude.com/docs/en/build-with-claude/skills-guide | 1455, 1473 | cURL examples |
Total scope: 1 page, 6 code examples affected
Cross-reference: The Prompt Caching FAQ explicitly states the beta prefix is no longer needed.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗