Skip to content
Back to search

agent-skills

Kapso agent skills for WhatsApp.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gokapso-agent-skills/badge.svg)](/listings/gokapso-agent-skills)

HTML

<a href="/listings/gokapso-agent-skills"><img src="/api/listings/gokapso-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add gokapso/agent-skills

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 94 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Kapso Agent Skills
  2. ![Kapso Agent Skills](https://app.kapso.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6ImI3YTg1NDE1LThjYzAtNGE2ZC04MGM3LWJhOGY2ODI0MTY3MSIsInB1ciI6ImJsb2JfaWQifX0=--1057c1ee33188e5afd42480e99937ae352e1a99b/kapso-agent-skills-image.png)
  3. > **Alpha**: These skills are in active development and subject to rapid change.
  4. Agent skills for [Kapso](https://kapso.ai), built on the open [Agent Skills](https://agentskills.io) format.
  5. ## Installation
  6. ```bash
  7. npx skills add gokapso/agent-skills
  8. ```
  9. ## Environment Variables
  10. Set these environment variables before using the skills:
  11. ```bash
  12. export KAPSO_API_BASE_URL="https://api.kapso.ai"
  13. export KAPSO_API_KEY="your-api-key"
  14. ```
  15. | Variable | Description |
  16. |----------|-------------|
  17. | `KAPSO_API_BASE_URL` | Kapso API host. Use `https://api.kapso.ai` |
  18. | `KAPSO_API_KEY` | API key from the Kapso web app at [app.kapso.ai](https://app.kapso.ai) |
  19. ## Path selection
  20. - Prefer the Kapso CLI when it is installed and already authenticated. The skill docs show CLI-first flows where the CLI already covers the task well.
  21. - Keep the provided scripts and direct API references as the fallback path when the CLI is unavailable or when a task still needs script-only operations.
  22. - If you use the CLI path, start with `kapso login` and `kapso status`.
  23. ## What are Agent Skills?
  24. Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to perform tasks more accurately. Each skill is a directory with a `SKILL.md` entrypoint and optional supporting files.
  25. ```
  26. my-skill/
  27. ├── SKILL.md # Required: instructions + metadata
  28. ├── scripts/ # Optional: executable code
  29. ├── references/ # Optional: documentation
  30. └── assets/ # Optional: templates, resources
  31. ```
  32. Skills use **progressive disclosure**: agents load only the name and description at startup, then read full instructions when a task matches. This keeps context usage efficient while giving agents access to detailed knowledge on demand.
  33. ## Available skills
  34. - **integrate-whatsapp-calling**: Connect voice agents, answer WhatsApp calls, handle outbound permission and dialing, and verify signaling/media
  35. - **integrate-whatsapp**: Connect WhatsApp, set up webhooks, send messages/templates, manage flows
  36. - **automate-whatsapp**: Build WhatsApp automations with workflows, agents, functions, and databases
  37. - **observe-whatsapp**: Search Logs, debug delivery issues, inspect webhook deliveries, triage errors, run health checks
  38. Each skill contains detailed documentation in its `SKILL.md` file.
  39. ## Maintenance
  40. Shared references in this repo also exist under `kapso-docs/skills/skills`. Keep mirrored docs in sync when updating shared onboarding or API guidance.
  41. Run the offline integration-skill regression tests with Node.js 20 or later:
  42. ```bash
  43. node --test tests/integrate-whatsapp.test.mjs
  44. ```
  45. The tests execute the bundled commands against a synthetic API double, compare supported requests and outputs with the recorded baseline, and exercise callback authentication, transport safeguards, and secret handling. They never contact Kapso or Meta. HTTPS API hosts remain configurable; trusted HTTP development endpoints require `KAPSO_ALLOW_INSECURE_HTTP=true`. See the integration skill's [credential handling](skills/integrate-whatsapp/references/webhooks-reference.md#credential-handling) for capturing one-time secrets privately.
  46. ## SKILL.md format
  47. Each skill requires a `SKILL.md` file with YAML frontmatter:
  48. ```yaml
  49. ---
  50. name: my-skill
  51. description: What this skill does and when to use it.
  52. ---
  53. # My Skill
  54. Instructions for the agent...
  55. ```
  56. | Field | Required | Description |
  57. |-------|----------|-------------|
  58. | `name` | Yes | Lowercase identifier (letters, numbers, hyphens) |
  59. | `description` | Yes | When to use this skill (max 1024 chars) |
  60. ## Learn more
  61. - [Agent Skills specification](https://agentskills.io/specification)
  62. - [Authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
  63. - [Example skills](https://github.com/anthropics/skills)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.