feat: add 61 new skills from VoltAgent repository
- 27 official team skills (Sentry, Trail of Bits, Expo, Hugging Face, etc.) - 34 community skills including context engineering suite - All skills validated and compliant with V4 quality bar - Complete source attribution maintained Skills added: - Official: commit, create-pr, find-bugs, iterate-pr, culture-index, fix-review, sharp-edges, expo-deployment, upgrading-expo, hugging-face-cli, hugging-face-jobs, vercel-deploy-claimable, design-md, using-neon, n8n-*, swiftui-expert-skill, fal-*, deep-research, imagen, readme, screenshots - Community: frontend-slides, linear-claude-skill, skill-rails-upgrade, context-*, multi-agent-patterns, tool-design, evaluation, memory-systems, terraform-skill, and more
This commit is contained in:
109
skills/observe-whatsapp/SKILL.md
Normal file
109
skills/observe-whatsapp/SKILL.md
Normal file
@@ -0,0 +1,109 @@
|
||||
---
|
||||
name: observe-whatsapp
|
||||
description: "Observe and troubleshoot WhatsApp in Kapso: debug message delivery, inspect webhook deliveries/retries, triage API errors, and run health checks. Use when investigating production issues, message failures, or webhook delivery problems."
|
||||
source: "https://github.com/gokapso/agent-skills/tree/master/skills/observe-whatsapp"
|
||||
risk: safe
|
||||
---
|
||||
|
||||
# Observe WhatsApp
|
||||
|
||||
## When to use
|
||||
|
||||
Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.
|
||||
|
||||
## Setup
|
||||
|
||||
Env vars:
|
||||
- `KAPSO_API_BASE_URL` (host only, no `/platform/v1`)
|
||||
- `KAPSO_API_KEY`
|
||||
|
||||
## How to
|
||||
|
||||
### Investigate message delivery
|
||||
|
||||
1. List messages: `node scripts/messages.js --phone-number-id <id>`
|
||||
2. Inspect message: `node scripts/message-details.js --message-id <id>`
|
||||
3. Find conversation: `node scripts/lookup-conversation.js --phone-number <e164>`
|
||||
|
||||
### Triage errors
|
||||
|
||||
1. Message errors: `node scripts/errors.js`
|
||||
2. API logs: `node scripts/api-logs.js`
|
||||
3. Webhook deliveries: `node scripts/webhook-deliveries.js`
|
||||
|
||||
### Run health checks
|
||||
|
||||
1. Project overview: `node scripts/overview.js`
|
||||
2. Phone number health: `node scripts/whatsapp-health.js --phone-number-id <id>`
|
||||
|
||||
## Scripts
|
||||
|
||||
### Messages
|
||||
|
||||
| Script | Purpose |
|
||||
|--------|---------|
|
||||
| `messages.js` | List messages |
|
||||
| `message-details.js` | Get message details |
|
||||
| `lookup-conversation.js` | Find conversation by phone or ID |
|
||||
|
||||
### Errors and logs
|
||||
|
||||
| Script | Purpose |
|
||||
|--------|---------|
|
||||
| `errors.js` | List message errors |
|
||||
| `api-logs.js` | List external API logs |
|
||||
| `webhook-deliveries.js` | List webhook delivery attempts |
|
||||
|
||||
### Health
|
||||
|
||||
| Script | Purpose |
|
||||
|--------|---------|
|
||||
| `overview.js` | Project overview |
|
||||
| `whatsapp-health.js` | Phone number health check |
|
||||
|
||||
### OpenAPI
|
||||
|
||||
| Script | Purpose |
|
||||
|--------|---------|
|
||||
| `openapi-explore.mjs` | Explore OpenAPI (search/op/schema/where) |
|
||||
|
||||
Install deps (once):
|
||||
```bash
|
||||
npm i
|
||||
```
|
||||
|
||||
Examples:
|
||||
```bash
|
||||
node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
|
||||
node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
|
||||
node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- For webhook setup (create/update/delete, signature verification, event types), use `integrate-whatsapp`.
|
||||
|
||||
## References
|
||||
|
||||
- [references/message-debugging-reference.md](references/message-debugging-reference.md) - Message debugging guide
|
||||
- [references/triage-reference.md](references/triage-reference.md) - Error triage guide
|
||||
- [references/health-reference.md](references/health-reference.md) - Health check guide
|
||||
|
||||
## Related skills
|
||||
|
||||
- `integrate-whatsapp` - Onboarding, webhooks, messaging, templates, flows
|
||||
- `automate-whatsapp` - Workflows, agents, and automations
|
||||
|
||||
<!-- FILEMAP:BEGIN -->
|
||||
```text
|
||||
[observe-whatsapp file map]|root: .
|
||||
|.:{package.json,SKILL.md}
|
||||
|assets:{health-example.json,message-debugging-example.json,triage-example.json}
|
||||
|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
|
||||
|scripts:{api-logs.js,errors.js,lookup-conversation.js,message-details.js,messages.js,openapi-explore.mjs,overview.js,webhook-deliveries.js,whatsapp-health.js}
|
||||
|scripts/lib/messages:{args.js,kapso-api.js}
|
||||
|scripts/lib/status:{args.js,kapso-api.js}
|
||||
|scripts/lib/triage:{args.js,kapso-api.js}
|
||||
```
|
||||
<!-- FILEMAP:END -->
|
||||
|
||||
Reference in New Issue
Block a user