Skip to main content
skill CX Codex

speak-reference-architecture — Claude Code skill: what it does

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.

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-reference-architecture -a claude-code
Open on GitHub

What speak-reference-architecture does

This skill lays out a production structure for language learning apps on the Speak platform. It covers the client, API gateway, assessment engine, and progress storage. The setup connects to Speak services that rely on OpenAI GPT-4o for tutoring and Whisper for speech recognition.

The implementation generates speak_reference_architecture_config.ts using SPEAK_API_KEY and SPEAK_APP_ID. It then imports SpeakClient from @speak/language-sdk and validates status via client.health.check(). Without finishing speak-install-auth first, calls fail with a 401 Unauthorized error. Audio files also require WAV 16kHz mono encoding, or the API rejects the payload with a codec error.

What it helps with

  • bootstrap a production architecture for language learning services
  • initialize @speak/language-sdk with an automated health check
  • integrate speech processing with Whisper and tutoring with GPT-4o
  • troubleshoot 401 errors and invalid audio codec issues

Example prompts for the agent

  • Set up the reference architecture for a Speak language learning app.
  • Create the configuration and initialize the SpeakClient from @speak/language-sdk.
  • Verify connectivity to the Speak API and configure health checking.

How to install speak-reference-architecture

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a claude-code

2Manually: put the files in place

~/.claude/skills/speak-reference-architecture/SKILL.md

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

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

Questions about speak-reference-architecture

How to install speak-reference-architecture in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a claude-code to install the skill. The file will be placed at ~/.claude/skills/speak-reference-architecture/SKILL.md.

What does speak-reference-architecture do?

It generates boilerplate configuration and integration logic for the Speak platform. It wires up the API gateway, connects GPT-4o and Whisper, and sets up health checking.

What are the prerequisites before applying this architecture?

You must complete speak-install-auth and provide valid SPEAK_API_KEY and SPEAK_APP_ID environment variables. Audio input must also be encoded as 16kHz mono WAV files.

Source text

SKILL.md · MIT
---
name: speak-reference-architecture
description: 'Production architecture for Speak language learning apps: client, API
  gateway, assessment engine, and progress store.

  Use when implementing reference architecture,

  or managing Speak language learning platform operations.

  Trigger with phrases like "speak reference architecture", "speak reference architecture".

  '
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 Reference Architecture

## Overview

Production architecture for Speak language learning apps: client, API gateway, assessment engine, and progress store.

## Prerequisites

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

## Instructions

### Step 1: Configuration

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

```typescript
// speak_reference_architecture_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 reference architecture
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 Reference Architecture 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 reference architecture 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 →
routing-dex-trades routing-dex-trades — a skill that pulls quotes from 1inch, Paraswap, and 0x to find swap routes with lower slippage and gas. Use it before trading to compare venues or split a large order. CX Codex +1 1installs 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-data-handling This skill sets up Speak data handling for student audio, assessment records, and learning progress with GDPR/COPPA considerations. 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

Project sponsors

Companies that keep this analytics open