К основному содержанию
скилл CX Codex

speak-hello-world — скилл для Claude Code

Скилл speak-hello-world для Claude Code, Codex, Cursor и других платформ, который создаёт сессию языкового обучения через API Speak с оценкой произношения и обратной связью.

MIT 1 установок ★ 2 935 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-hello-world -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/speak-hello-world/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/speak-hello-world/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
hello-world-agent disler Субагент hello-world-agent для Claude Code, который здоровается с пользователем и спрашивает, чем помочь. Срабатывает на фразы «hi claude», «hi cc» или «hi claude code». CX Codex ★ 3 990звёзд репо etl-connector-strategy Samuel Berthe Скилл etl-connector-strategy помогает решить, стоит ли SaaS-продукту появляться источником в чужих ETL/ELT-каталогах, на какой платформе и какой путь сборки выбрать. CX Codex +1 10 400установок pre-generation-check bitwize-music-studio Скилл pre-generation-check проверяет готовность трека или альбома к генерации в Suno и выдаёт итог READY или NOT READY. CX Codex +1 264установок speak-tts EmZod Скилл speak-tts даёт агенту голос: озвучивает текст, статьи и книги прямо на Mac, без API-ключей и облака. CX Codex +1 739установок MantleKit Launch Planner gcampton MCP-сервер MantleKit Launch Planner для Claude Code, который превращает идеи SaaS в структурированные проекты с планами запуска и подбором тем оформления. CX Codex +1 632установок KanseiLink michie-y MCP-сервер KanseiLink ищет сведения о SaaS API: авторизацию, эндпоинты, подводные камни и обходные решения. Пригодится перед интеграцией сервиса в проект. CX Codex +1 612установок

Из того же набора139

Весь набор →
calculating-crypto-taxes Скилл calculating-crypto-taxes обрабатывает выгрузки сделок с бирж и считает налог на криптовалюту. Помогает свести операции по методам FIFO, LIFO или HIFO и подготовить отчёт по форме 8949. CX Codex +1 1установок finding-arbitrage-opportunities Скилл finding-arbitrage-opportunities сравнивает лучшие bid и ask для криптопары на биржах, считает спреды с комиссиями и ищет треугольные циклы. Подходит для проверки арбитражных разниц. CX Codex +1 1установок routing-dex-trades Скилл routing-dex-trades для Claude Code собирает котировки 1inch, Paraswap и 0x и ищет маршрут свопа с минимальным проскальзыванием и расходом газа. Сравнивает цены на DEX и разбивает крупные ордера. CX Codex +1 1установок simulating-flash-loans Скилл simulating-flash-loans симулирует мгновенные займы через Aave V3, dYdX и Balancer без траты реальных токенов. Рассчитывает чистую прибыль арбитража, ликвидаций и комиссии за газ. CX Codex +1 1установок speak-cost-tuning Скилл speak-cost-tuning для Claude Code настраивает мониторинг использования Speak API. Помогает следить за расходами уже написанной интеграции. CX Codex +1 1установок speak-reference-architecture Скилл speak-reference-architecture помогает развернуть архитектуру приложения для изучения языков на платформе Speak: клиент, API-шлюз и подсистемы прогресса. Пригодится при настройке бэкенда со связкой GPT-4o и Whisper. CX Codex +1 1установок speak-data-handling Скилл speak-data-handling помогает настроить обработку аудио учеников, результатов оценивания и прогресса в Speak с учётом GDPR/COPPA. CX Codex +1 1установок image-optimization-helper Скилл image-optimization-helper для Claude Code помогает оптимизировать изображения во фронтенд-проектах. Активируется по фразам вроде «image helper» или «image». CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой