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

1. 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.