--- name: together-upgrade-migration-f02ee9bbd498 description: >- Migrate Together AI Python SDK v1, OpenAI-compatible clients, deprecated models, or legacy dedicated endpoints with inventory, contract tests, canaries, and rollback. Use when upgrading Together dependencies or provider resources. Trigger with "upgrade Together SDK", "Together model migration", or "migrate Together endpoint v1". argument-hint: "[repository-path] [sdk|model|endpoint] [target]" allowed-tools: Read, Glob, Grep, WebFetch, Write, Edit version: 1.9.0 author: Jeremy Longshore license: MIT tags: - saas - together-ai - migration model: inherit effort: high compatibility: Designed for Claude Code; live migration verification requires authorized Together AI access --- # Together AI Upgrade and Migration ## Overview This skill moves one Together contract at a time while preserving response, model-quality, cost, and rollback evidence. ## Prerequisites - An inventory of SDK versions, API calls, model IDs, and dedicated resources - Current migration, model lifecycle, and deprecation documentation - Golden requests/evaluations plus latency and cost baselines - A rollback target and owners for traffic, data, billing, and teardown ## Tool Discipline Use `Read`, `Glob`, and `Grep` to locate dependencies, direct calls, model constants, response assumptions, and endpoint management. Use `WebFetch` for current migration and deprecation contracts. Use `Write` or `Edit` only after scope and rollback are agreed. ## Current Contract - Python v1 is maintenance-only; new features target `together>=2.0.0` and may use changed method/response shapes. - OpenAI-compatible migration requires Together's base URL, project key, and Together model IDs. - Same-lineage model upgrades may redirect after notice; materially new models require explicit migration and evaluation. - New dedicated capacity uses v2 DMI; legacy v1 create/restart paths are retired. ## Authentication Preserve project-scoped `TOGETHER_API_KEY` injection while changing clients or endpoints. Never reuse development keys in production or expose a key during dual-run comparison. ## Instructions 1. Classify the migration as SDK, model, compatibility layer, or dedicated endpoint and freeze the baseline. 2. Inventory every call, parameter, response field, model, job, retry, and management resource in scope. 3. Build contract and golden-quality tests before changing dependencies or routing. 4. Implement the target behind a reversible configuration or traffic boundary. 5. Canary with sanitized requests; compare behavior, latency, usage, errors, limits, and cost. 6. Promote explicitly, monitor, remove obsolete resources only after retention/rollback approval, and update the runbook. ## Approval Boundaries Do not accept silent model substitution, delete legacy endpoints, revoke keys, or shift production traffic without evaluated behavior and an executable rollback. ## Output Return source/target contracts, inventory, test delta, canary metrics, model/deprecation evidence, traffic state, rollback proof, obsolete-resource disposition, and owners. ## Error Handling | Condition | Response | |---|---| | SDK response shape changes | Adapt at the provider boundary and keep caller contracts stable. | | Model quality regresses | Roll back routing and revisit the candidate. | | Legacy endpoint cannot restart | Move to v2 DMI; do not rely on v1 recovery. | | Redirect is detected | Record the effective model and run migration evaluations. | ## Examples The example below shows the minimum redacted evidence expected from a successful invocation of this operator workflow. ```text source=python-v1; target=python-v2; contracts=pass; canary=pass; rollback=verified ``` ## Resources - [Skill-specific official documentation](references/official-docs.md) - [Python v2 migration](https://docs.together.ai/docs/pythonv2-migration-guide) - [Deprecations](https://docs.together.ai/docs/deprecations) - [Dedicated v1 migration](https://docs.together.ai/docs/dedicated-endpoints/migrate-from-v1) --- Source attribution: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/together-pack/skills/together-upgrade-migration/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 Jeremy Longshore Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/together-pack/skills/together-upgrade-migration/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Development & Engineering, Product Management Roles: Data Scientist, ML / AI Engineer, Product Manager Specialties: API Tools: Together Ai Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 34cedb8a2e782329192ffe3ed0db8d5bf256daade2f175231c2fc5d1b4cbf105