Skip to main content
skill CX Codex

speak-data-handling — Claude Code skill: data and install

This skill sets up Speak data handling for student audio, assessment records, and learning progress with GDPR/COPPA considerations.

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-data-handling -a claude-code
Open on GitHub

What speak-data-handling does

The skill guides a Speak integration that works with student audio, assessment records, and learning progress. It configures SPEAK_API_KEY, SPEAK_APP_ID, and NODE_ENV, creates a SpeakClient from @speak/language-sdk, and checks the service with client.health.check().

It also includes an API check with curl and guidance for common failures: invalid credentials, rate limits, network timeouts, and unsupported audio codecs. Speak uses GPT-4o for AI tutoring and Whisper for speech recognition. An invalid SPEAK_API_KEY causes a 401 response.

The setup expects speak-install-auth to be completed, valid API credentials, and familiarity with Speak API patterns. For codec failures, the instructions call for WAV 16kHz mono audio.

What it helps with

  • handle student audio in Speak
  • check Speak API health
  • connect SPEAK_API_KEY and SPEAK_APP_ID to the integration
  • diagnose 401, 429, and connection timeout errors
  • convert audio to WAV 16kHz mono

Example prompts for the agent

  • Set up Speak data handling and check the integration health.
  • Verify the Speak connection with SPEAK_API_KEY and SPEAK_APP_ID.
  • Investigate a Speak audio codec error and prepare the required file format.

How to install speak-data-handling

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-data-handling -a claude-code

2Manually: put the files in place

~/.claude/skills/speak-data-handling/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/speak-data-handling/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about speak-data-handling

How do I install speak-data-handling in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-data-handling -a claude-code. The installed skill file is at ~/.claude/skills/speak-data-handling/SKILL.md.

What does speak-data-handling do?

It guides Speak data handling for student audio, assessment records, and learning progress, then checks the API and addresses common integration errors.

What does the skill require before use?

Complete speak-install-auth, configure valid API credentials, and understand Speak API patterns. The setup uses SPEAK_API_KEY and SPEAK_APP_ID.

Source text

SKILL.md · MIT
---
name: speak-data-handling
description: 'Handle student audio data, assessment records, and learning progress
  with GDPR/COPPA compliance.

  Use when implementing data handling,

  or managing Speak language learning platform operations.

  Trigger with phrases like "speak data handling", "speak data handling".

  '
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 Data Handling

## Overview

Handle student audio data, assessment records, and learning progress with GDPR/COPPA compliance.

## Prerequisites

- Completed `speak-install-auth` setup
- Valid API credentials configured
- Understanding of Speak API patterns

## Instructions

### Step 1: Configuration

Configure data handling for your Speak integration. Speak uses OpenAI's GPT-4o for AI tutoring and Whisper for speech recognition.

```typescript
// speak_data_handling_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 data handling
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 Data Handling 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 data handling 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 Data and databases →

From the same set139

The whole set →
simulating-flash-loans simulating-flash-loans simulates flash loans across Aave V3, dYdX, and Balancer without spending real tokens. It estimates arbitrage and liquidation net profits, gas costs, and execution risks. CX Codex +1 1installs speak-hello-world speak-hello-world — a skill for Claude Code, Codex, Cursor, and other platforms that sets up a language tutoring session via the Speak API with pronunciation scoring and real-time feedback. CX Codex +1 1installs speak-cost-tuning speak-cost-tuning — a skill that tunes costs for a Speak API integration. It monitors usage, picks a tier, and makes audio processing cheaper. CX Codex +1 1installs speak-reference-architecture speak-reference-architecture sets up a production architecture for Speak language learning apps, spanning the client, API gateway, and progress store. Useful when building a backend that integrates GPT-4o and Whisper. CX Codex +1 1installs image-optimization-helper image-optimization-helper — an auto-activating skill for image optimization tasks in frontend projects. It kicks in on phrases like "image helper" or "image". CX Codex +1 1installs open-graph-creator open-graph-creator generates Open Graph markup and configurations for frontend projects. Activates when setting up page metadata and validating tag parameters. CX Codex +1 1installs audit-trail-helper The audit-trail-helper skill guides audit-trail work with step-by-step advice, generated code and configurations, and checks against common standards. CX Codex +1 1installs twinmind-data-handling twinmind-data-handling — a Claude Code skill for TwinMind meeting data: transcript storage, memory vault, export and GDPR deletion policies. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open