{
  "markdown": "# Kapso Agent Skills\n\n![Kapso Agent Skills](https://app.kapso.ai/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6ImI3YTg1NDE1LThjYzAtNGE2ZC04MGM3LWJhOGY2ODI0MTY3MSIsInB1ciI6ImJsb2JfaWQifX0=--1057c1ee33188e5afd42480e99937ae352e1a99b/kapso-agent-skills-image.png)\n\n> **Alpha**: These skills are in active development and subject to rapid change.\n\nAgent skills for [Kapso](https://kapso.ai), built on the open [Agent Skills](https://agentskills.io) format.\n\n## Installation\n\n```bash\nnpx skills add gokapso/agent-skills\n```\n\n## Environment Variables\n\nSet these environment variables before using the skills:\n\n```bash\nexport KAPSO_API_BASE_URL=\"https://api.kapso.ai\"\nexport KAPSO_API_KEY=\"your-api-key\"\n```\n\n| Variable | Description |\n|----------|-------------|\n| `KAPSO_API_BASE_URL` | Kapso API host. Use `https://api.kapso.ai` |\n| `KAPSO_API_KEY` | API key from the Kapso web app at [app.kapso.ai](https://app.kapso.ai) |\n\n## Path selection\n\n- 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.\n- 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.\n- If you use the CLI path, start with `kapso login` and `kapso status`.\n\n## What are Agent Skills?\n\nAgent 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.\n\n```\nmy-skill/\n├── SKILL.md          # Required: instructions + metadata\n├── scripts/          # Optional: executable code\n├── references/       # Optional: documentation\n└── assets/           # Optional: templates, resources\n```\n\nSkills 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.\n\n## Available skills\n\n- **integrate-whatsapp**: Connect WhatsApp, set up webhooks, send messages/templates, manage flows\n- **automate-whatsapp**: Build WhatsApp automations with workflows, agents, functions, and databases\n- **observe-whatsapp**: Search Logs, debug delivery issues, inspect webhook deliveries, triage errors, run health checks\n\nEach skill contains detailed documentation in its `SKILL.md` file.\n\n## Maintenance\n\nShared references in this repo also exist under `kapso-docs/skills/skills`. Keep mirrored docs in sync when updating shared onboarding or API guidance.\n\n## SKILL.md format\n\nEach skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: my-skill\ndescription: What this skill does and when to use it.\n---\n\n# My Skill\n\nInstructions for the agent...\n```\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| `name` | Yes | Lowercase identifier (letters, numbers, hyphens) |\n| `description` | Yes | When to use this skill (max 1024 chars) |\n\n## Learn more\n\n- [Agent Skills specification](https://agentskills.io/specification)\n- [Authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)\n- [Example skills](https://github.com/anthropics/skills)\n",
  "bytes": 3296,
  "sha": "1f0419b31907b2349806507024e2cb4ce3027c00e64e8b63aa67dd3a39cc720f",
  "repo_slug": "gokapso/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_gokapso_agent_skills_automate_whatsapp_96b6f64f/readme"
}