From speak-pack
Upgrades @speak/language-sdk, migrates Speak API endpoints, and maps Duolingo/Babbel data for language learning app integrations.
How this skill is triggered — by the user, by Claude, or both
Slash command
/speak-pack:speak-upgrade-migrationThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Upgrade Speak SDK versions, migrate between language learning platforms, and handle API version changes.
Upgrade Speak SDK versions, migrate between language learning platforms, and handle API version changes.
speak-install-auth setup!npm list @speak/language-sdk 2>/dev/null || echo 'Speak SDK not installed'
npm list @speak/language-sdk
npm outdated @speak/language-sdk
npm install @speak/language-sdk@latest
npm test # Run tests to verify compatibility
// Check for deprecated endpoints
const DEPRECATED_ENDPOINTS = [
'/v1/lessons/start', // Replaced by /v1/conversations/start
'/v1/speech/score', // Replaced by /v1/pronunciation/assess
];
// Migration map
const ENDPOINT_MIGRATION = {
'/v1/lessons/start': '/v1/conversations/start',
'/v1/speech/score': '/v1/pronunciation/assess',
};
// Map learning data between platforms
interface MigrationMapper {
mapProficiencyLevel(source: string): 'beginner' | 'intermediate' | 'advanced';
mapLanguageCode(source: string): string;
mapProgress(source: any): SpeakProgress;
}
const duolingoMapper: MigrationMapper = {
mapProficiencyLevel(crowns: string) {
const c = parseInt(crowns);
if (c < 3) return 'beginner';
if (c < 6) return 'intermediate';
return 'advanced';
},
mapLanguageCode: (code) => code, // Same ISO codes
mapProgress: (duo) => ({
vocabulary: duo.words_learned,
level: duolingoMapper.mapProficiencyLevel(duo.crowns),
}),
};
npm test
node -e "const s = require('@speak/language-sdk'); console.log('SDK version:', s.version || 'loaded OK')"
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Invalid API key | Verify SPEAK_API_KEY environment variable |
| 429 Rate Limited | Too many requests | Wait Retry-After seconds, use backoff |
| Audio format error | Wrong codec/sample rate | Convert to WAV 16kHz mono with ffmpeg |
| Session expired | Timeout after 30 min | Start a new conversation session |
See speak-prod-checklist for production readiness.
Basic: Apply upgrade migration with default configuration for a standard Speak integration.
Advanced: Customize for production with error recovery, monitoring, and team-specific requirements.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin speak-packGuides migration to Speak language learning platform: import student progress, transition legacy speech APIs using TypeScript SDK and OpenAI integration.
Guides Deepgram SDK upgrades from v3/v4 to v5 and Nova-2 to Nova-3 model migrations using code maps, validation scripts, and rollback procedures.
Upgrades ElevenLabs JS/Python SDKs and migrates v1-v2/v3 models, handling package renames, import changes, and API deprecations.