Agent skill

Observe Whatsapp

by gokapso in gokapso/agent-skills

Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run…

No licenceAuto-check passedBackend & APIs

Install Observe Whatsapp

skills CLI
$ npx skills add gokapso/agent-skills --skill observe-whatsapp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gokapso/agent-skills observe-whatsapp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gokapso/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/observe-whatsapp .claude/skills/observe-whatsapp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
observe-whatsapp
GitHub stars
177
Token cost
~1.8k tokens
SKILL.md length
675 words
Files
25 (incl. scripts, references, assets)
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run…

  • Works in 4 steps: Search the current project: kapso logs… → If the exact search is empty, retry with… → Add --problems-only for broad error… → …
  • Investigating production issues
  • SKILL.md covers When to use, Setup, How to and Scripts, plus 3 more sections
  • Runs JavaScript scripts from its folder; calls node and npm; needs KAPSO_API_KEY

What it does

Observe Whatsapp is an agent skill from gokapso/agent-skills. Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run health checks. Use when investigating production issues, message failures, workflow behavior, or webhook delivery problems.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 30 other files, including scripts, reference files and assets (for example `assets/health-example.json`, `assets/message-debugging-example.json` and `assets/triage-example.json`).

It sits in Backend & APIs, covering Webhooks. It works with WhatsApp. The repository describes itself as: Kapso agent skills for WhatsApp.

When your agent uses it

  • Investigating production issues
  • Message failures
  • Workflow behavior
  • Webhook delivery problems

Example prompts

  • “/observe-whatsapp”

Requirements

  • Node.js
  • A credential in KAPSO_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Search the current project: kapso logs search --query "" --period 24h --source all --limit 20 --output json
  2. If the exact search is empty, retry with --period 7d before concluding there are no logs.
  3. Add --problems-only for broad error scans; leave it off when reconstructing an exact timeline.
  4. Add explicit filters only when they intentionally narrow the search

What it can do on your machine

Read from SKILL.md and the folder at commit 415c1b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 7 files in scripts/ (JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • KAPSO_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Observe Whatsapp loads about 1.8k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 675 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 675 words (~1,824 tokens).

“Use this skill for operational diagnostics: Logs search, message delivery investigation, webhook delivery debugging, error triage, workflow event correlation, and WhatsApp health checks.”

— opening of SKILL.md by gokapso
name
observe-whatsapp

Read the full SKILL.md on GitHub

Files

SKILL.md and 24 other files (scripts, references, assets) in skills/observe-whatsapp of gokapso/agent-skills.

  • SKILL.md
  • assets/health-example.json
  • assets/message-debugging-example.json
  • assets/triage-example.json
  • package.json
  • references/health-reference.md
  • references/message-debugging-reference.md
  • references/triage-reference.md
  • scripts/api-logs.js
  • scripts/errors.js
  • scripts/lib/messages/args.js
  • scripts/lib/messages/kapso-api.js
  • scripts/lib/status/args.js
  • scripts/lib/status/kapso-api.js
  • scripts/lib/triage
  • … and 10 more

Open the folder on GitHubat commit 415c1b4

Compare with similar skills

Observe Whatsapp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Observe Whatsapp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Observe Whatsapp this skillgokapso/agent-skills177—~1.8kAutomated safety check: PassNone
Whatsapp Cloud APIsickn33/agentic-awesome-skills47k2 repos~4.5kAutomated safety check: PassMIT
Channel Debug Corevercel-labs/vercel-openclaw-archived117—~2kAutomated safety check: NotesMIT
Frontmcp Channelsagentfront/frontmcp146—~3.7kAutomated safety check: PassApache-2.0
Workspace APIfriday-platform/friday-studio104—~9.3kAutomated safety check: NotesCustom licence
Int Evolution APIevolution-foundation/evo-nexus545—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Backend & APIsAuto-check passed
  • Channel Debug Core

    vercel-labs/vercel-openclaw-archived

    Official

    Channel webhook triage for vercel-openclaw Slack/Telegram/Discord/WhatsApp issues: prove deployment state, collect admin readiness endpoints, build evidence-first handoff before fixes.

    117 GitHub stars~2k tokensUpdated 4 mo ago
    Backend & APIsAuto-check: notes
  • Frontmcp Channels

    agentfront/frontmcp

    A skill your agent uses when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges.

    146 GitHub stars~3.7k tokensUpdated today
    Backend & APIsAuto-check passed
  • Workspace API

    friday-platform/friday-studio

    Create, list, update, delete, and clean up workspaces via the daemon HTTP API at $FRIDAYDURL.

    104 GitHub stars~9.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Int Evolution API

    evolution-foundation/evo-nexus

    Manage WhatsApp instances and send messages via the Evolution API.

    545 GitHub stars~1.6k tokensUpdated 5 mo ago
    Backend & APIsAuto-check passed
  • Integration Channel

    ChatbotXIO/ChatbotX

    Create and modify integration channels (messenger, whatsapp, zalo, tiktok, threads, webchat, etc.) for the chatbot platform.

    885 GitHub stars~8k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from gokapso/agent-skills

  • Integrate Whatsapp

    gokapso/agent-skills

    Connect WhatsApp to your product with Kapso: onboard customers with setup links, detect connections, receive events via webhooks, and send messages/templates/media.

    177 GitHub stars~4.8k tokensUpdated yesterday
    Auto-check passed
  • Automate Whatsapp

    gokapso/agent-skills

    Build and debug Kapso WhatsApp workflows, triggers, functions, and executions.

    177 GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed
  • Integrate Whatsapp Calling

    gokapso/agent-skills

    Connect voice agents to WhatsApp Calling through Kapso. An agent skill from gokapso/agent-skills.

    177 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Observe Whatsapp

What does Observe Whatsapp do?

Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run…. Observe Whatsapp is an agent skill from gokapso/agent-skills. Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run health checks.

When should I use Observe Whatsapp?

Observe Whatsapp fits situations like: investigating production issues; message failures; workflow behavior; webhook delivery problems.

How do I install Observe Whatsapp in Claude Code?

Run `npx skills add gokapso/agent-skills --skill observe-whatsapp -a claude-code`. Or copy the skill folder (skills/observe-whatsapp in gokapso/agent-skills) into .claude/skills/observe-whatsapp in your project. Claude Code loads it when a task matches its description.

How do I install Observe Whatsapp in Codex?

Run `npx skills add gokapso/agent-skills --skill observe-whatsapp -a codex`. Or copy the skill folder (skills/observe-whatsapp in gokapso/agent-skills) into .agents/skills/observe-whatsapp in your project. Codex loads it when a task matches its description.

Can I use Observe Whatsapp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gokapso/agent-skills --skill observe-whatsapp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/observe-whatsapp, .gemini/skills/observe-whatsapp, .github/skills/observe-whatsapp and .opencode/skills/observe-whatsapp in your project.

What does Observe Whatsapp need to run?

Going by SKILL.md and its folder, Observe Whatsapp needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node and npm) and credentials named KAPSO_API_KEY. Our summary lists: Node.js; A credential in KAPSO_API_KEY.

Does Observe Whatsapp access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Observe Whatsapp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Observe Whatsapp use?

No licence was found for Observe Whatsapp or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Observe Whatsapp use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Observe Whatsapp?

Skills that share tags, products or a category with Observe Whatsapp: Whatsapp Cloud API (sickn33/agentic-awesome-skills, 47k stars), Channel Debug Core (vercel-labs/vercel-openclaw-archived, 117 stars), Frontmcp Channels (agentfront/frontmcp, 146 stars) and Workspace API (friday-platform/friday-studio, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Observe Whatsapp?

gokapso (a GitHub organization) maintains it in gokapso/agent-skills, which has 177 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 9, 2026.

Source: gokapso/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.