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