Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-migration-deep-dive -a claude-code
Open on GitHub

What 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-sdk client
  • 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-code

2Manually: put the files in place

~/.claude/skills/speak-migration-deep-dive/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/speak-migration-deep-dive/

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

Similar skills

All skills for Backend and APIs →

From the same set139

The whole set →
code-documentation-analyzer Auto-activating skill for auditing code documentation: API references, user guides, architecture docs. Triggers on phrases like "code documentation analyzer" or "code analyzer". CX Codex +1 1installs retellai-policy-guardrails retellai-policy-guardrails sets boundaries and tool limits for Retell AI phone voice agents. Useful when you need reliable call workflows with human handoffs. CX Codex +1 1installs openevidence-deploy-integration openevidence-deploy-integration plans an OpenEvidence rollout for a clinical workflow, covering the pilot, staff training, governance checks, and rollback conditions. CX Codex +1 1installs speak-install-auth speak-install-auth — a skill to integrate Speak, an AI language tutoring platform powered by GPT-4o and OpenAI Realtime. Configures API credentials, speech recognition, and prepares your environment to run lessons across 14+ languages. CX Codex +1 1installs lokalise-core-workflow-a lokalise-core-workflow-a — a Claude Code skill for the source-to-Lokalise direction: uploading translation files, creating and editing keys. Also runs in Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 1installs api-contract Generates an api-contract.md file that backend and frontend agents read as one shared interface. No back-and-forth needed during a sprint. CX Codex +1 1installs openrouter-cost-controls openrouter-cost-controls sets hard budget caps and tracks OpenRouter API spending across keys to prevent accidental balance drain. CX Codex +1 1installs instantly-cost-tuning The instantly-cost-tuning skill reviews Instantly usage and compares plan and account-capacity options. Use it when assessing workspace consumption before a capacity decision. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open