speak-migration-deep-dive — Claude Code skill: how to install
speak-migration-deep-dive migrates language learning platforms to Speak, imports student progress, and configures the @speak/language-sdk client.
MIT 1 installs ★ 2,935 updated 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a claude-codeWhat speak-migration-deep-dive does
This skill guides the transition to the Speak language learning platform. It creates speak_migration_deep_dive_config.ts using SPEAK_API_KEY and SPEAK_APP_ID, then initializes @speak/language-sdk to check endpoint status via health.check().
Under the hood, Speak relies on GPT-4o for tutoring interactions and Whisper for speech-to-text processing. Connectivity can be tested directly with a curl call targeting https://api.speak.com/v1/health.
Without prior completion of speak-install-auth, API calls fail immediately on authentication. If the service returns an audio format error, input files must be converted to 16kHz mono WAV.
What it helps with
- migrate student records from legacy language learning platforms
- replace old speech APIs with the Speak and Whisper stack
- configure the TypeScript
@speak/language-sdkclient - test API connectivity against
https://api.speak.com/v1/health
Example prompts for the agent
- Run speak migration deep dive and generate the configuration file
- Help me import student progress data into the Speak platform
- Resolve an audio format error in Speak by preparing a 16kHz mono WAV file
How to install speak-migration-deep-dive
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a claude-code2Manually: put the files in place
~/.claude/skills/speak-migration-deep-dive/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/speak-migration-deep-dive/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a codex2Manually: put the files in place
.agents/skills/speak-migration-deep-dive/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a cursor2Manually: put the files in place
.cursor/skills/speak-migration-deep-dive/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/speak-migration-deep-dive2Manually: put the files in place
.github/skills/speak-migration-deep-dive/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/speak-migration-deep-diveManually: put the files in place
.devin/skills/speak-migration-deep-dive/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about speak-migration-deep-dive
How do I install speak-migration-deep-dive in Claude Code?
Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a claude-code. You can also manually add the skill file at ~/.claude/skills/speak-migration-deep-dive/SKILL.md.
What does speak-migration-deep-dive do?
It guides the transition to the Speak platform, helping transfer student progress records and replace legacy speech APIs.
What audio format does Speak require?
When an audio codec error occurs, convert your sound files to 16kHz mono WAV format.
Source text
SKILL.md · MIT
--- name: speak-migration-deep-dive description: 'Migrate between language learning platforms, import student progress, and transition from legacy speech APIs. Use when implementing migration deep dive, or managing Speak language learning platform operations. Trigger with phrases like "speak migration deep dive", "speak migration deep dive". ' allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep version: 1.14.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - saas - speak - api compatibility: Designed for Claude Code --- # Speak Migration Deep Dive ## Overview Migrate between language learning platforms, import student progress, and transition from legacy speech APIs. ## Prerequisites - Completed `speak-install-auth` setup - Valid API credentials configured - Understanding of Speak API patterns ## Instructions ### Step 1: Configuration Configure migration deep dive for your Speak integration. Speak uses OpenAI's GPT-4o for AI tutoring and Whisper for speech recognition. ```typescript // speak_migration_deep_dive_config.ts const config = { apiKey: process.env.SPEAK_API_KEY!, appId: process.env.SPEAK_APP_ID!, environment: process.env.NODE_ENV || 'development', }; ``` ### Step 2: Implementation ```typescript // Core implementation for speak migration deep dive import { SpeakClient } from '@speak/language-sdk'; const client = new SpeakClient(config); // Production-ready implementation async function setup() { const health = await client.health.check(); console.log("Status:", health.status); return health; } ``` ### Step 3: Verification ```bash curl -sf -H "Authorization: Bearer $SPEAK_API_KEY" https://api.speak.com/v1/health | jq . ``` ## Output - Speak Migration Deep Dive configured and verified - Production-ready Speak integration - Error handling and monitoring in place ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | 401 Unauthorized | Invalid API key | Verify SPEAK_API_KEY | | 429 Rate Limited | Too many requests | Implement backoff | | Connection timeout | Network issue | Check connectivity to api.speak.com | | Audio format error | Wrong codec | Convert to WAV 16kHz mono | ## Resources - [Speak Website](https://speak.com) - [OpenAI Realtime API](https://platform.openai.com/docs/guides/realtime) - [Speak GPT-4 Blog](https://speak.com/blog/speak-gpt-4) ## Next Steps For production checklist, see `speak-prod-checklist`. ## Examples **Basic**: Apply migration deep dive with default settings for a standard Speak integration. **Production**: Configure with monitoring, alerting, and team-specific language learning requirements.
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace