Speak CI Integration

Overview

Integrate Speak language learning API validation into CI/CD pipelines. Covers pronunciation analysis endpoint testing, lesson content validation, API response format verification, and regression testing for language assessment accuracy.

Prerequisites

• Speak API key stored as GitHub secret

• GitHub Actions configured

• Test framework (Vitest or Jest)

• Audio test fixtures for pronunciation tests

Instructions

• For full implementation details, load: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Error Handling

Issue Cause Solution

API key invalid Secret not set Add SPEAK_API_KEY to repo secrets

Audio fixture too large Uncompressed WAV Compress to 16-bit mono

Lesson validation fails Missing required field Check schema and fix JSON files

Flaky pronunciation test Audio quality varies Use consistent test recordings

Examples

Minimal Smoke Test

• name: Speak API health check env: SPEAK_API_KEY: ${{ secrets.SPEAK_API_KEY }} run: | curl -s -H "Authorization: Bearer $SPEAK_API_KEY"
  https://api.speak.com/v1/languages | jq '.languages | length'

Resources

• Speak API Documentation

• Speak Developer Guide

Output

• Configuration files or code changes applied to the project

• Validation report confirming correct implementation

• Summary of changes made and their rationale

See CI/CD implementation details for output format specifications.