speak-hello-world — скилл для Claude Code
Скилл speak-hello-world для Claude Code, Codex, Cursor и других платформ, который создаёт сессию языкового обучения через API Speak с оценкой произношения и обратной связью.
MIT 1 установок ★ 2 935 обновлён 2026-10-29
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a claude-codeЧто делает speak-hello-world
Создаёт диалоговую сессию с AI-репетитором, отправляет ответы студента (текст или аудио), оценивает произношение на уровне фонем и слов, показывает грамматические ошибки и новую лексику. Внутри TypeScript-код с клиентом SpeakClient, который инициализирует сессию, обрабатывает ответы и завершает урок с метриками обучения.
Для работы нужны уже настроенные креденшалы из speak-install-auth — API-ключ и App ID в переменных окружения SPEAK_API_KEY и SPEAK_APP_ID. Поддерживает испанский, корейский, японский, французский и немецкий. Оценка произношения работает с WAV-файлами 16 кГц моно; если записаны с другим кодеком или частотой, сервер вернёт ошибку.
Какие задачи решает
- создать первую сессию языкового обучения через Speak API
- оценить произношение отдельной фразы с разбором по фонемам
- получить обратную связь по грамматике и новой лексике за урок
- протестировать интеграцию Speak перед полноценной разработкой
- запустить диалоговую практику на разных языках
Примеры запросов агенту
- Создай первый урок испанского с приветствиями и оценкой моего произношения
- Запусти speak-hello-world, чтобы проверить, работают ли мои API-ключи Speak
- Тестируй сессию на английском с текстовыми ответами, без микрофона
Как установить speak-hello-world
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a claude-code2Вручную: положить файлы
~/.claude/skills/speak-hello-world/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/speak-hello-world/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a codex2Вручную: положить файлы
.agents/skills/speak-hello-world/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a cursor2Вручную: положить файлы
.cursor/skills/speak-hello-world/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/speak-hello-world2Вручную: положить файлы
.github/skills/speak-hello-world/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/speak-hello-worldВручную: положить файлы
.devin/skills/speak-hello-world/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о speak-hello-world
Как установить speak-hello-world в Claude Code?
Запусти npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a claude-code, а затем открой ~/.claude/skills/speak-hello-world/SKILL.md. Для других платформ команда отличается: для Codex — npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a codex, для Cursor — npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a cursor, для GitHub Copilot — gh skill install jeremylongshore/tons-of-skills-marketplace speak-hello-world.
Что делает speak-hello-world?
Создаёт учебную сессию с AI-репетитором, обрабатывает ответы студента, оценивает произношение на уровне фонем и слов, показывает ошибки грамматики и новую лексику, завершает сессию с метриками обучения.
Какие ошибки бывают и как их исправить?
Если аудиофайл в неправильном формате, конвертируй его в WAV 16 кГц моно. При истечении времени сессии начни новую. Если язык не поддерживается, используй коды из списка: es, ko, ja, fr, de. При низкой оценке произношения запиши в тихой комнате.
Исходный текст
SKILL.md · MIT
--- name: speak-hello-world description: 'Create your first Speak AI tutoring session with pronunciation feedback. Use when starting a new Speak integration, testing your setup, or learning basic language learning API patterns. Trigger with phrases like "speak hello world", "speak example", "speak quick start", "first speak lesson". ' allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(node:*) version: 1.14.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - saas - speak - api - testing compatibility: Designed for Claude Code --- # Speak Hello World ## Overview Create your first AI tutoring session with Speak. Demonstrates conversation practice, pronunciation assessment, and real-time feedback using GPT-4o-powered tutoring. ## Prerequisites - Completed `speak-install-auth` setup - Valid API credentials configured - Microphone access (optional for testing) ## Instructions ### Step 1: Start a Conversation Session ```typescript import { SpeakClient } from '@speak/language-sdk'; const client = new SpeakClient({ apiKey: process.env.SPEAK_API_KEY!, appId: process.env.SPEAK_APP_ID!, language: 'es', }); // Start a beginner Spanish lesson const session = await client.startConversation({ scenario: 'greetings', language: 'es', level: 'beginner', nativeLanguage: 'en', }); console.log('Session ID:', session.id); console.log('AI Tutor:', session.firstPrompt.text); // Output: "Hola! Bienvenido a tu leccion de espanol. Como te llamas?" console.log('Audio URL:', session.firstPrompt.audioUrl); ``` ### Step 2: Send a Student Response ```typescript // Submit text response (or audio file for pronunciation scoring) const turn = await client.sendTurn(session.id, { text: 'Hola, me llamo Juan. Mucho gusto.', // Or: audioPath: './recordings/response.wav' }); console.log('Tutor response:', turn.tutorText); console.log('Pronunciation score:', turn.pronunciationScore); // 0-100 console.log('Grammar corrections:', turn.corrections); // Output: [{original: "me llamo", suggestion: null, correct: true}] console.log('Vocabulary notes:', turn.vocabularyNotes); ``` ### Step 3: Pronunciation Assessment ```typescript // Assess pronunciation of a specific phrase const assessment = await client.assessPronunciation({ audioPath: './recordings/hola-como-estas.wav', targetText: 'Hola, como estas?', language: 'es', detailLevel: 'phoneme', // 'word' or 'phoneme' }); console.log(`Overall score: ${assessment.score}/100`); for (const word of assessment.words) { console.log(` "${word.text}": ${word.score}/100`); if (word.phonemes) { for (const p of word.phonemes.filter(p => p.score < 70)) { console.log(` Weak phoneme: ${p.symbol} (${p.score}) - ${p.suggestion}`); } } } ``` ### Step 4: End Session and Review ```typescript const summary = await client.endSession(session.id); console.log('Session Summary:'); console.log(` Duration: ${summary.durationMinutes} min`); console.log(` Turns: ${summary.totalTurns}`); console.log(` Pronunciation: ${summary.avgPronunciationScore}/100`); console.log(` Grammar: ${summary.grammarAccuracy}%`); console.log(` New vocabulary: ${summary.newWords.join(', ')}`); ``` ## Output - Working conversation session with AI tutor - Pronunciation assessment with phoneme-level feedback - Session summary with learning metrics - Console output showing scores and corrections ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | Session timeout | Exceeded max duration | Start a new session | | Audio format invalid | Wrong codec or sample rate | Convert to WAV 16kHz mono | | Language not supported | Invalid language code | Use supported codes (es, ko, ja, fr, de) | | Low pronunciation score | Background noise | Record in a quiet environment | | Rate limit exceeded | Too many requests | Wait and retry with backoff | ## Resources - [Speak Website](https://speak.com) - [Speak GPT-4 Blog](https://speak.com/blog/speak-gpt-4) - [OpenAI Realtime API](https://platform.openai.com/docs/guides/realtime) ## Next Steps Proceed to `speak-local-dev-loop` for development workflow setup. ## Examples **Text-only test**: Skip audio and use text responses to test the conversation flow before integrating microphone input. **Multi-language**: Start sessions in different languages by changing the `language` parameter to `ko` (Korean), `ja` (Japanese), or `fr` (French).
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace