speak-reference-architecture — скилл для Claude Code: что делает
Скилл speak-reference-architecture помогает развернуть архитектуру приложения для изучения языков на платформе Speak: клиент, API-шлюз и подсистемы прогресса. Пригодится при настройке бэкенда со связкой GPT-4o и Whisper.
MIT 1 установок ★ 2 935 обновлён 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a claude-codeЧто делает speak-reference-architecture
Скилл задаёт типовую архитектуру для сервисов на платформе Speak, связывая клиентское приложение, API-шлюз, модуль оценки речи и хранилище прогресса. Для диалогов и транскрипции платформа использует GPT-4o и Whisper. В проект добавляется файл конфигурации speak_reference_architecture_config.ts с переменными SPEAK_API_KEY и SPEAK_APP_ID, а также клиент SpeakClient из библиотеки @speak/language-sdk.
Работоспособность окружения проверяется вызовом client.health.check() или прямым GET-запросом к https://api.speak.com/v1/health. Без предварительной настройки speak-install-auth сервис вернёт статус 401 Unauthorized. Для передачи аудиопотока обязателен формат WAV 16 кГц моно, иначе API выдаст ошибку кодека.
Какие задачи решает
- развернуть архитектуру для приложения изучения языков
- настроить подключение клиента
@speak/language-sdkс проверкой доступности API - интегрировать распознавание речи Whisper и диалоги через GPT-4o
- диагностировать ошибки 401 и неподдерживаемый формат аудиофайлов
Примеры запросов агенту
- Разверни типовую архитектуру для сервиса изучения языков на базе платформы Speak.
- Создай конфигурационный файл и инициализируй клиент
@speak/language-sdk. - Проверь доступность API Speak и настрой проверку статуса сервиса.
Как установить speak-reference-architecture
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a claude-code2Вручную: положить файлы
~/.claude/skills/speak-reference-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/speak-reference-architecture/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a codex2Вручную: положить файлы
.agents/skills/speak-reference-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a cursor2Вручную: положить файлы
.cursor/skills/speak-reference-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/speak-reference-architecture2Вручную: положить файлы
.github/skills/speak-reference-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/speak-reference-architectureВручную: положить файлы
.devin/skills/speak-reference-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о speak-reference-architecture
Как установить speak-reference-architecture в Claude Code?
Для установки выполните команду npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-reference-architecture -a claude-code. Навык сохранится по пути ~/.claude/skills/speak-reference-architecture/SKILL.md.
Что делает скилл speak-reference-architecture?
Он создаёт базовую конфигурацию и код подключения к API Speak. Скилл связывает клиент со шлюзом, подключает работу с GPT-4o и Whisper, а также добавляет проверку статуса сервиса.
Что нужно подготовить перед запуском архитектуры?
Сначала требуется завершить настройку speak-install-auth и задать ключи SPEAK_API_KEY и SPEAK_APP_ID. Если планируется отправка аудио, файлы необходимо подготовить в формате WAV 16 кГц моно.
Исходный текст
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