skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
gokapso/agent-skills87 installs

kapso-ops

Operate and troubleshoot Kapso projects. Manage webhooks, debug message delivery, inspect API errors, and run health checks. Use when diagnosing issues, setting up webhooks, or investigating message failures.

How do I install this agent skill?

npx skills add https://github.com/gokapso/agent-skills --skill kapso-ops
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The kapso-ops skill is an operational utility for managing Kapso platform projects and troubleshooting WhatsApp message delivery. It uses standard environment variables for authentication and executes local helper scripts for specific tasks. No malicious patterns, obfuscation, or unauthorized data exfiltration were detected.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · No issues

What does this agent skill do?

Kapso Ops

When to use

Use this skill for operational diagnostics: webhook setup, message delivery investigation, error triage, and WhatsApp health checks.

Setup

Env vars:

  • KAPSO_API_BASE_URL (host only, no /platform/v1)
  • KAPSO_API_KEY

How to

Set up a webhook

  1. Create: node scripts/create.js --phone-number-id <id> --url <https://...> --events <csv>
  2. Verify signature handling (see references/webhooks-overview.md)
  3. Test: node scripts/test.js --webhook-id <id>

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

Webhooks

ScriptPurpose
list.jsList webhooks for a phone number
get.jsGet webhook details
create.jsCreate a webhook
update.jsUpdate a webhook
delete.jsDelete a webhook
test.jsSend a test event to a webhook

Common flags for create/update:

  • --url <https://...> - Webhook URL
  • --events <csv> - Event types (comma-separated)
  • --kind <kapso|meta> - Webhook type
  • --payload-version <v1|v2> - Payload format (v2 recommended)
  • --buffer-enabled <true|false> - Enable buffering
  • --active <true|false> - Enable/disable

Messages

ScriptPurpose
messages.jsList messages
message-details.jsGet message details
lookup-conversation.jsFind conversation by phone or ID

Errors and logs

ScriptPurpose
errors.jsList message errors
api-logs.jsList external API logs
webhook-deliveries.jsList webhook delivery attempts

Health

ScriptPurpose
overview.jsProject overview
whatsapp-health.jsPhone number health check

Notes

  • Use config-level webhooks for whatsapp.message.* events
  • Payload version v2 is recommended for new integrations
  • Meta webhooks provide raw payloads; Kapso webhooks support buffering

References

Related skills

  • kapso-automation - Automation and functions
  • whatsapp-messaging - WhatsApp messaging
  • kapso-api - Platform API and customers

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/gokapso/agent-skills/kapso-ops">View kapso-ops on skillZs</a>