jeremylongshore / speak-reference-architecture
Install for your project team
Run this command in your project directory to install the skill for your entire team:
mkdir -p .claude/skills/speak-reference-architecture && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3074" && unzip -o skill.zip -d .claude/skills/speak-reference-architecture && rm skill.zipProject Skills
This skill will be saved in .claude/skills/speak-reference-architecture/ and checked into git. All team members will have access to it automatically.
Important: Please verify the skill by reviewing its instructions before using it.
Implement Speak reference architecture with best-practice project layout for language learning apps. Use when designing new Speak integrations, reviewing project structure, or establishing architecture standards for language learning applications. Trigger with phrases like "speak architecture", "speak best practices", "speak project structure", "how to organize speak", "speak layout".
Skill Content
---
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.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
compatible-with: claude-code, codex, openclaw
tags: [saas, speak, api]
---
# 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.