Agent skill · software engineering · jeremylongshore
groq-upgrade-migration
Upgrade groq-sdk versions and handle Groq model deprecations.
Why this skill is useful
Provides specific commands and workflows for upgrading the groq-sdk and handling model deprecations that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, git, jq, npm installed locally. Requires groq account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Groq Upgrade & Migration Current State !npm list groq-sdk 2>/dev/null grep groq-sdk echo 'groq-sdk not installed' !pip show groq 2>/dev/null grep -E "Name Version" echo 'groq not installed (python)' Overview Guide for upgrading the groq-sdk package and migrating away from deprecated model IDs. It walks a safe upgrade path — branch, bump, scan for deprecated model references, rewrite them, and verify against the live models endpoint before merging. Prerequisites A Node project that depends on groq-sdk (or the Python groq package). npm, git, curl, and jq available on PATH. Authentication: GROQAPIKEY exported in your shell (or CI secret store). The SDK constructor new Groq() reads it automatically; the live model check passes it as Authorization: Bearer $GROQAPIKEY. Get a key at <https://console.groq.com/keys>. See the Authentication section of references/implementation.md. Model Deprecation Timeline Groq announces deprecations with advance notice. These models have been deprecated: Deprecated Model Deprecation Date Replacement ----------------- ----------------- ------------- mixtral-8x7b-32768 2025-03-05 llama-3.3-70b-versatile or llama-3.1-8b-instant gemma2-9b-it 2025-08-08 llama-3.1-8b-instant llama-3.1-70b-versatile 2024-12-06 llama-3.3-70b-versatile llama-3.1-70b-specdec 2024-12-06 llama-3.3-70b-specdec playai-tts 2025-12-23 Orpheus TTS models playai-tts-arabic 2025-12-23 Orpheus TTS models distil-whisper-large-v3-en — whisper-large-v3-turbo Current Model IDs (Use These) Model ID Type Context Speed ---------- ------ --------- ------- llama-3.1-8b-instant Text 128K ~560 tok/s llama-3.3-70b-versatile Text 128K ~280 tok/s llama-3.3-70b-specdec Text 128K Faster meta-llama/llama-4-scout-17b-16e-instruct Vision+Text 128K ~460 tok/s meta-llama/llama-4-maverick-17b-128e-instruct Vision+Text 128K — whisper-large-v3 Audio STT — 164x RT whisper-large-v3-turbo Audio STT — 216x RT Always verify against the live endpoint: GET https://api.groq.com/openai/v1/models. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/groq-upgrade-migration