Index of every page on this site: llms.txt
All skills
davila7 avatar

/claude-opus-4-5-migration

@053feb2
Run it yourself

Migrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5. Use when the user wants to update their codebase, prompts, or API calls to use Opus 4.5. Handles model string updates and prompt adjustments for known Opus 4.5 behavioral differences. Does NOT migrate Haiku 4.5.

Use this Skill: https://skilld.dev/gh/davila7/claude-code-templates/claude-opus-4-5-migration

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈81 tokens for metadata: the name and description. ≈1.1k when used: this file. ≈2k more on demand in 2 files.

Description uses 4.1% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈325 characters, or 4.1%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Opus 4.5 Migration Guide

One-shot migration from Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5.

Migration Workflow

  1. Search codebase for model strings and API calls
  2. Update model strings to Opus 4.5 (see platform-specific strings below)
  3. Remove unsupported beta headers
  4. Add effort parameter set to "high" (see references/effort.md)
  5. Summarize all changes made
  6. Tell the user: "If you encounter any issues with Opus 4.5, let me know and I can help adjust your prompts."

Model String Updates

Identify which platform the codebase uses, then replace model strings accordingly.

Unsupported Beta Headers

Remove the context-1m-2025-08-07 beta header if present—it is not yet supported with Opus 4.5. Leave a comment noting this:

# Note: 1M context beta (context-1m-2025-08-07) not yet supported with Opus 4.5

Target Model Strings (Opus 4.5)

Platform Opus 4.5 Model String
Anthropic API (1P) claude-opus-4-5-20251101
AWS Bedrock anthropic.claude-opus-4-5-20251101-v1:0
Google Vertex AI claude-opus-4-5@20251101
Azure AI Foundry claude-opus-4-5-20251101

Source Model Strings to Replace

Source Model Anthropic API (1P) AWS Bedrock Google Vertex AI
Sonnet 4.0 claude-sonnet-4-20250514 anthropic.claude-sonnet-4-20250514-v1:0 claude-sonnet-4@20250514
Sonnet 4.5 claude-sonnet-4-5-20250929 anthropic.claude-sonnet-4-5-20250929-v1:0 claude-sonnet-4-5@20250929
Opus 4.1 claude-opus-4-1-20250422 anthropic.claude-opus-4-1-20250422-v1:0 claude-opus-4-1@20250422

Do NOT migrate: Any Haiku models (e.g., claude-haiku-4-5-20251001).

Prompt Adjustments

Opus 4.5 has known behavioral differences from previous models. Only apply these fixes if the user explicitly requests them or reports a specific issue. By default, just update model strings.

Integration guidelines: When adding snippets, don't just append them to prompts. Integrate them thoughtfully:

  • Use XML tags (e.g., <code_guidelines>, <tool_usage>) to organize additions
  • Match the style and structure of the existing prompt
  • Place snippets in logical locations (e.g., coding guidelines near other coding instructions)
  • If the prompt already uses XML tags, add new content within appropriate existing tags or create consistent new ones

1. Tool Overtriggering

Opus 4.5 is more responsive to system prompts. Aggressive language that prevented undertriggering on previous models may now cause overtriggering.

Apply if: User reports tools being called too frequently or unnecessarily.

Find and soften:

  • CRITICAL: → remove or soften
  • You MUST... → You should...
  • ALWAYS do X → Do X
  • NEVER skip... → Don't skip...
  • REQUIRED → remove or soften

Only apply to tool-triggering instructions. Leave other uses of emphasis alone.

2. Over-Engineering Prevention

Opus 4.5 tends to create extra files, add unnecessary abstractions, or build unrequested flexibility.

Apply if: User reports unwanted files, excessive abstraction, or unrequested features. Add the snippet from references/prompt-snippets.md.

3. Code Exploration

Opus 4.5 can be overly conservative about exploring code, proposing solutions without reading files.

Apply if: User reports the model proposing fixes without inspecting relevant code. Add the snippet from references/prompt-snippets.md.

4. Frontend Design

Apply if: User requests improved frontend design quality or reports generic-looking outputs.

Add the frontend aesthetics snippet from references/prompt-snippets.md.

5. Thinking Sensitivity

When extended thinking is not enabled (the default), Opus 4.5 is particularly sensitive to the word "think" and its variants. Extended thinking is enabled only if the API request contains a thinking parameter.

Apply if: User reports issues related to "thinking" while extended thinking is not enabled (no thinking parameter in request).

Replace "think" with alternatives like "consider," "believe," or "evaluate."

Reference

See references/prompt-snippets.md for the full text of each snippet to add.

See references/effort.md for configuring the effort parameter (only if user requests it).

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning1mo5 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill facilitates the migration of codebases and system prompts to the Claude Opus 4.5 model. It provides guidance on updating model strings, implementing new API parameters like 'effort', and adjusting prompt instructions to account for behavioral changes in the new model. While the skill is functionally safe, it operates by reading and modifying a user's codebase, which is a standard surface for indirect prompt injection.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • Runlayer9mo

    3/3 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 053feb2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last year

README badge

README badge for davila7/claude-code-templates/claude-opus-4-5-migration