Update claude-api skill: mark four retired model IDs as retired by adi-IL · Pull Request #1607 · anthropics/skills

adi-IL · 2026-08-18T17:35:59Z

Update claude-api skill: mark four retired model IDs as retired

What was wrong

skills/claude-api/shared/models.md still listed claude-opus-4-1 under "Legacy Models (still active)" and claude-sonnet-4-0, claude-opus-4-0, and claude-3-haiku-20240307 under "Deprecated Models (retiring soon)". All four IDs return 404 from the Messages API, and each retirement date on the official Model deprecations page has already passed:

claude-opus-4-1-20250805: retired Aug 5, 2026
claude-opus-4-20250514: retired June 15, 2026
claude-sonnet-4-20250514: retired June 15, 2026
claude-3-haiku-20240307: retired Apr 20, 2026

The file explicitly tells the reader to trust these IDs over their own knowledge, so the stale rows were recommending models that fail on first use.

What changed

Moved the four IDs into the "Retired Models (no longer available)" table in models.md with their official retirement dates.
Removed the now-empty "Deprecated Models (retiring soon)" sections from models.md and model-migration.md.
Moved the same three IDs in model-migration.md into the "Retired Model Replacements" table.
Updated the "Resolving User Requests" rows in models.md from "deprecated" to "Retired — suggest ..." so the suggested replacements stay reachable.

Verification

Checked every status and date against the official Model deprecations page (fetched from platform.claude.com/docs/en/about-claude/model-deprecations).
Confirmed no other references to these four IDs remain in the claude-api skill outside the two edited files.
Rendered the edited markdown tables locally to confirm column alignment.

I could not call the Messages API directly from my environment because no ANTHROPIC_API_KEY is set, so the 404 claims come from the issue reproduction and the official deprecations page rather than a live curl.

98zc5g5jyw-arch · 2026-08-23T09:37:58Z

Babysit review — LGTM ✅

Four retired model IDs moved to retired with correct retirement dates and successor models (claude-opus-4-8, claude-sonnet-5, claude-haiku-4-5). Information accurate.

98zc5g5jyw-arch

Hermes Review

Verdict: Comment — correct and useful model-status update; two cross-file consistency nits.

Verified

Moving the four models (opus-4, sonnet-4, haiku-3, opus-4.1) to "Retired" is consistent with their retirement windows having passed (all ≤ Aug 2026 vs. repo's reference date).
The effort/alias guidance updates are consistent within models.md.

Warnings

Retirement date drift within the PR: the removed "Deprecated" table in model-migration.md listed claude-3-haiku-20240307 retiring Apr 19, 2026, but the new "Retired" rows say Apr 20, 2026. models.md in the same PR says Apr 20. If Apr 20 is the correct canonical date, fine — but call it out, since the change is silently different from what the repo previously documented.
claude-opus-4-1 missing from model-migration.md: models.md now lists claude-opus-4-1-20250805 as Retired (Aug 5, 2026), but model-migration.md's retired table is not updated with it. The two files will disagree.

Suggestions

Add claude-opus-4-1-20250805 → claude-opus-4-8 (or opus-5, per the alias table) to model-migration.md's retired table, and reconcile the haiku-3 date in one place.

Reviewed by Hermes Agent (cron babysitter)

adi-IL · 2026-08-23T13:35:59Z

Thanks for the review @98zc5g5jyw-arch! Added claude-opus-4-1-20250805 to model-migration.md's retired table and reconciled the claude-3-haiku-20240307 retirement date to Apr 19, 2026 across both models.md and model-migration.md.

98zc5g5jyw-arch

Re-review after bdff74f: cross-file consistency nits addressed — claude-opus-4-1-20250805 added to retired model table with drop-in replacement, Haiku 3 retirement date aligned (Apr 19) across model-migration.md and models.md. LGTM.

adi-IL · 2026-08-26T18:01:01Z

Hi @98zc5g5jyw-arch, just checking if everything looks good to land this PR, or if any additional adjustments are needed.

GBX-Max1220 · 2026-09-28T20:15:54Z

Small date correction: Anthropic's official model deprecations page lists claude-3-haiku-20240307 as retired on April 20, 2026, rather than April 19. This PR currently uses Apr 19 in both shared/models.md and shared/model-migration.md. Could you update both rows to the official date?

https://platform.claude.com/docs/en/about-claude/model-deprecations

98zc5g5jyw-arch · 2026-09-28T20:39:56Z

Reviewed at the follow-up head dd93cab.

Both follow-ups from your replies are in place at this head: claude-opus-4-1-20250805 added to shared/model-migration.md, and the empty "Deprecated Models (retiring soon)" sections removed from both files.

Verified at dd93cab

✅ Four IDs moved into the Retired tables in shared/models.md and shared/model-migration.md; the "Resolving User Requests" rows now say Retired - suggest … .
✅ These dates match the official model deprecations page: claude-opus-4-1-20250805 → Aug 5, 2026; claude-opus-4-20250514 → Jun 15, 2026; claude-sonnet-4-20250514 → Jun 15, 2026.
✅ No other references to the four IDs remain elsewhere in skills/claude-api (grep over the whole tree — only these two files).
✅ Merges cleanly against current main (git merge-tree rc=0; MERGEABLE).

One correction (same as @GBX-Max1220's note; verified against the page):

shared/models.md:98 — Claude Haiku 3 retired April 20, 2026, not Apr 19, 2026 (deprecated Feb 19, 2026).
shared/model-migration.md:212 — same fix for the claude-3-haiku-20240307 row.

Your PR body already states "retired Apr 20, 2026" — these two table rows are the only places still on Apr 19. (My earlier review said "correct retirement dates" while that row was already reconciled to Apr 19 — the off-by-one slipped through on my side; Apr 20 is the official date.)

Non-blocking: quick_validate.py currently fails on claude-api because the SKILL.md description is 1068 chars — pre-existing on main and unrelated to this PR (it doesn't touch SKILL.md).

# Conflicts: # skills/claude-api/shared/model-migration.md # skills/claude-api/shared/models.md

adi-IL · 2026-10-03T07:15:00Z

Thanks @GBX-Max1220. I checked the model deprecations page and you are right. claude-3-haiku-20240307 now shows Apr 20, 2026 in both shared/models.md and shared/model-migration.md (3d1c8b7).

I also merged upstream main (dd66d1c). Main now lists newer default models, so bf5eddf sets the suggested replacements for the newly retired IDs to the ones the deprecations page recommends. Those are claude-opus-4-8, claude-sonnet-4-6 and claude-haiku-4-5-20251001. This is a docs change, so I checked the diff and the rendered tables. There is no test to run.

98zc5g5jyw-arch · 2026-10-04T13:15:55Z

Follow-up re-review at head bf5eddfc00.

Delta since dd93cab307: three commits — 3d1c8b7 (haiku-3 rows Apr 19 → Apr 20 in both files — the correction from my previous review), dd66d1c (merge of upstream/main, pulling in #1930's claude-api updates; conflicts in the two shared files were resolved cleanly), and bf5eddf ("Use the official replacement models for newly retired IDs").

Verified at bf5eddfc00

✅ The Apr 20 correction is in place: shared/models.md:102 — Claude Haiku 3, Apr 20, 2026; shared/model-migration.md:219 — claude-3-haiku-20240307, Apr 20, 2026. No Apr 19 remains anywhere under skills/claude-api.
✅ All four retirement dates match the official Model deprecations page: claude-opus-4-1-20250805 → Aug 5, 2026; claude-opus-4-20250514 → Jun 15, 2026; claude-sonnet-4-20250514 → Jun 15, 2026; claude-3-haiku-20240307 → Apr 20, 2026.
✅ The bf5eddf replacements now match the official "Recommended replacement" column for these four IDs: claude-opus-4-8 (both opus rows — unchanged), claude-sonnet-4-6, claude-haiku-4-5-20251001. This commit fixes a real post-merge regression: after dd66d1c the sonnet-4 row had picked up upstream's "newest model" suggestion (claude-sonnet-5-5) rather than the official replacement.
✅ models.md "Resolving User Requests" rows read Retired - suggest … and are consistent with the new IDs (opus 4.1/opus 4 → claude-opus-4-8; sonnet 4 → claude-sonnet-4-6; haiku 3 → claude-haiku-4-5, i.e. the alias form of claude-haiku-4-5-20251001).
✅ The four IDs still appear only in the two edited files (whole-tree grep over skills/claude-api), and the merge did not resurrect any "Deprecated Models (retiring soon)" sections.

Non-blocking observation

Sibling retired rows the PR doesn't own still diverge from the same official table: claude-3-7-sonnet-20250219 and claude-3-5-sonnet-2024{1022,0620} suggest claude-sonnet-5-5 (official: claude-sonnet-4-6), and claude-3-5-haiku-20241022 suggests claude-haiku-4-5 (official dated ID: claude-haiku-4-5-20251001). Out of scope for this PR's four IDs — only worth a follow-up if the replacement column is meant to mirror the official page exactly.

LGTM from my side; the two earlier items are fully addressed.

adi-IL · 2026-10-05T09:02:29Z

Closing this. The four model IDs stay retired upstream, and keeping the PR open is not worth the noise.

98zc5g5jyw-arch reviewed Aug 23, 2026

View reviewed changes

98zc5g5jyw-arch approved these changes Aug 24, 2026

View reviewed changes

Update claude-api skill: mark four retired model IDs as retired

dd93cab

adi-IL force-pushed the fix/retired-model-ids branch from bdff74f to dd93cab Compare September 1, 2026 18:42

This was referenced Sep 14, 2026

📊 AI CLI 工具社区动态日报 2026-09-14 96loveslife/big_model_radar#486

Open

📊 AI CLI 工具社区动态日报 2026-09-17 96loveslife/big_model_radar#502

Open

98zc5g5jyw-arch mentioned this pull request Sep 28, 2026

docs(claude-api): update retired model statuses and tables in models.md (#1603) #1650

Open

98zc5g5jyw-arch mentioned this pull request Sep 28, 2026

Update claude-api skill: Claude Opus 5.5 default, Claude Sonnet 5.5, build-eval and hillclimb guides #1930

Merged

github-actions Bot mentioned this pull request Oct 2, 2026

📊 AI CLI 工具社区动态日报 2026-10-03 litang9/big_model_radar#488

Open

adi-IL added 3 commits October 3, 2026 06:26

Fix claude-3-haiku-20240307 retirement date to Apr 20, 2026

3d1c8b7

Merge remote-tracking branch 'upstream/main' into bot/skills-1607

dd66d1c

# Conflicts: # skills/claude-api/shared/model-migration.md # skills/claude-api/shared/models.md

Use the official replacement models for newly retired IDs

bf5eddf

This was referenced Oct 3, 2026

📊 AI CLI 工具社区动态日报 2026-10-04 litang9/big_model_radar#493

Open

📊 AI CLI 工具社区动态日报 2026-10-04 96loveslife/big_model_radar#585

Open

github-actions Bot mentioned this pull request Oct 5, 2026

📊 AI CLI 工具社区动态日报 2026-10-05 96loveslife/big_model_radar#590

Open

adi-IL closed this Oct 5, 2026

Navigation Menu

Repository navigation

Update claude-api skill: mark four retired model IDs as retired - #1607

Update claude-api skill: mark four retired model IDs as retired#1607
adi-IL wants to merge 4 commits into
anthropics:mainfrom
adi-IL:fix/retired-model-ids

adi-IL commented Aug 18, 2026

Uh oh!

98zc5g5jyw-arch commented Aug 23, 2026

Uh oh!

98zc5g5jyw-arch left a comment

Uh oh!

adi-IL commented Aug 23, 2026

Uh oh!

98zc5g5jyw-arch left a comment

Uh oh!

adi-IL commented Aug 26, 2026

Uh oh!

GBX-Max1220 commented Sep 28, 2026

Uh oh!

98zc5g5jyw-arch commented Sep 28, 2026

Uh oh!

adi-IL commented Oct 3, 2026

Uh oh!

98zc5g5jyw-arch commented Oct 4, 2026

Uh oh!

adi-IL commented Oct 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

adi-IL commented Aug 18, 2026

What was wrong

What changed

Verification

Uh oh!

98zc5g5jyw-arch commented Aug 23, 2026

Babysit review — LGTM ✅

Uh oh!

98zc5g5jyw-arch left a comment

Choose a reason for hiding this comment

Hermes Review

Verified

Warnings

Suggestions

Uh oh!

adi-IL commented Aug 23, 2026

Uh oh!

98zc5g5jyw-arch left a comment

Choose a reason for hiding this comment

Uh oh!

adi-IL commented Aug 26, 2026

Uh oh!

GBX-Max1220 commented Sep 28, 2026

Uh oh!

98zc5g5jyw-arch commented Sep 28, 2026

Uh oh!

adi-IL commented Oct 3, 2026

Uh oh!

98zc5g5jyw-arch commented Oct 4, 2026

Uh oh!

adi-IL commented Oct 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants