Speak prod checklist
'Production readiness checklist for Speak language learning integrations: auth, audio pipeline, monitoring, and compliance.From its SKILL.md
npx -y skills add jeremylongshore/claude-code-plugins-plus-skills --skill speak-prod-checklistAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.3 KB, 641 tokens by cl100k_base, as published. Nobody here has run it
Speak Production Checklist
Overview
Production readiness checklist for Speak language learning integrations: auth, audio pipeline, monitoring, and compliance.
Prerequisites
- Completed
speak-install-authsetup - Valid API credentials configured
- ffmpeg installed for audio processing
Instructions
Authentication
- API keys stored in secrets manager
- Key rotation schedule established (90 days)
- Separate keys for dev/staging/production
- Error handling for expired keys
Audio Pipeline
- Audio preprocessor converts to WAV 16kHz mono
- File size validation (< 25MB)
- Duration validation (0.5s - 60s)
- Background noise detection/warning
- Fallback for unsupported audio formats
Rate Limiting & Performance
- Rate-limited client wrapper implemented
- Retry logic with exponential backoff on 429
- Request queue for batch assessments
- Response caching where appropriate
Monitoring & Alerting
- API response time tracking
- Error rate monitoring (target < 1%)
- Rate limit hit tracking
- Assessment score distribution monitoring
- Session completion rate tracking
Compliance
- Student data privacy policy documented
- Audio data retention policy implemented
- COPPA compliance verified (if applicable)
- FERPA compliance verified (if educational)
- GDPR data processing agreement (if EU users)
Verification Script
#!/bin/bash
set -euo pipefail
echo "Speak Production Readiness"
curl -sf -H "Authorization: Bearer $SPEAK_API_KEY" \
https://api.speak.com/v1/health | jq '.status'
echo " Auth: PASS"
ffmpeg -version > /dev/null 2>&1 && echo " ffmpeg: PASS" || echo " ffmpeg: FAIL"
echo "Checks complete."
Output
- Checklist implementation complete
- Speak API integration verified
- Production-ready patterns applied
Error Handling
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Invalid API key | Verify SPEAK_API_KEY environment variable |
| 429 Rate Limited | Too many requests | Wait Retry-After seconds, use backoff |
| Audio format error | Wrong codec/sample rate | Convert to WAV 16kHz mono with ffmpeg |
| Session expired | Timeout after 30 min | Start a new conversation session |
Resources
Next Steps
See speak-prod-checklist for production readiness.
Examples
Basic: Apply prod checklist with default configuration for a standard Speak integration.
Advanced: Customize for production with error recovery, monitoring, and team-specific requirements.
What ships with it: 1 file
6.5 KB alongside SKILL.md
references/
- implementation-guide.md6.5 KB