AI skills for Africa's Talking APIs (SMS, USSD, Voice, Airtime)
# Africa's Talking API Skills
Claude Code skills for the Africa's Talking APIs — SMS, USSD, Voice, and Airtime.
Built by **Brian Mwangi**, Community Co-Lead at Africa's Talking.
---
## What Are Skills?
Skills are markdown prompt files that teach an AI assistant the exact API contracts, error codes, and debugging steps for a specific domain. When a skill is active, the AI can:
- Help you implement any Africa's Talking API in any language
- Debug common errors (406 User Blacklisted, auth failures, callback setup issues)
- Create Postman collections for these APIs on request
This repo contains 4 skills:
| Skill | File | What it covers |
|-------|------|----------------|
| Airtime | `airtime.md` | Send airtime, check transaction status |
| SMS | `sms.md` | Bulk SMS (new + legacy), Premium SMS, 406 blacklist fix |
| Voice | `voice.md` | Outbound calls, IVR XML actions, inbound call webhooks |
| USSD | `ussd.md` | CON/END session handling, sandbox setup, ngrok |
---
## Setup for Claude Code Users
### 1. Create the skills folder
Claude Code looks for skills in `~/.claude/skills/`. Create it if it doesn't exist:
```sh
mkdir -p ~/.claude/skills
```
### 2. Download the skills
```sh
# Airtime
curl -o ~/.claude/skills/africastalking-airtime.md \
raw.githubusercontent.com
# SMS
curl -o ~/.claude/skills/africastalking-sms.md \
raw.githubusercontent.com
# Voice
curl -o ~/.claude/skills/africastalking-voice.md \
raw.githubusercontent.com
# USSD
curl -o ~/.claude/skills/africastalking-ussd.md \
raw.githubusercontent.com
```
Or download all 4 at once:
```sh
for api in airtime sms voice ussd; do
curl -o ~/.claude/skills/africastalking-${api}.md \
raw.githubusercontent.com …