Agent skill

Int Evolution API

by evolution-foundation in evolution-foundation/evo-nexus

Manage WhatsApp instances and send messages via the Evolution API.

Custom licenceAuto-check passedBackend & APIs

Install Int Evolution API

skills CLI
$ npx skills add evolution-foundation/evo-nexus --skill int-evolution-api -a claude-code

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

GitHub CLI
$ gh skill install evolution-foundation/evo-nexus int-evolution-api --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/evolution-foundation/evo-nexus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/int-evolution-api .claude/skills/int-evolution-api && 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
int-evolution-api
GitHub stars
545
Token cost
~1.6k tokens
SKILL.md length
206 words
Files
2 (incl. scripts)
Skills in repo
117
Repo updated
First seen
Licence
Custom licence

At a glance

Manage WhatsApp instances and send messages via the Evolution API.

  • Works in 2 steps: Get your API URL and global API key from… → Set environment variables
  • You need to list/create/connect instances
  • SKILL.md covers Setup (one-time), Instance Management, Send Messages and Chat Operations, plus 1 more section
  • Runs Python scripts from its folder; calls python3; reaches api.evolution-api.com; needs EVOLUTION_API_KEY

What it does

Int Evolution API is an agent skill from evolution-foundation/evo-nexus. Manage WhatsApp instances and send messages via the Evolution API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, buttons, lists, polls), query chats/contacts, manage groups, or configure webhooks. Calls the Evolution API REST endpoints directly.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/evolution_api_client.py`).

It sits in Backend & APIs, covering Webhooks and REST APIs. It works with WhatsApp. The repository describes itself as: The open source operating system for AI-powered businesses.

When your agent uses it

  • You need to list/create/connect instances
  • Send messages (text
  • Query chats/contacts
  • Configure webhooks

Example prompts

  • “/int-evolution-api”

Requirements

  • Python 3
  • A credential in EVOLUTION_API_KEY

Workflow steps

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

  1. Get your API URL and global API key from your Evolution API instance.
  2. Set environment variables

What it can do on your machine

Read from SKILL.md and the folder at commit 7f5dd76. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.evolution-api.com

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

  • Credentials

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

    • EVOLUTION_API_KEY

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

Context cost

Int Evolution API loads about 1.6k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 206 words (~1,558 tokens).

“Interact with your Evolution API instance to manage WhatsApp connections, send messages, query chats, manage groups, and configure webhooks.”

— opening of SKILL.md by evolution-foundation, Custom licence
name
int-evolution-api

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .claude/skills/int-evolution-api of evolution-foundation/evo-nexus.

  • SKILL.md
  • scripts/evolution_api_client.py

Open the folder on GitHubat commit 7f5dd76

Compare with similar skills

Int Evolution API 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.

Int Evolution API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Int Evolution API this skillevolution-foundation/evo-nexus545—~1.6kAutomated safety check: PassCustom licence
Workspace APIfriday-platform/friday-studio104—~9.3kAutomated safety check: NotesCustom licence
API Patternsdilolabs/nosia2131 repos~2.5kAutomated safety check: PassMIT
Integrate Whatsappgokapso/agent-skills175—~4.8kAutomated safety check: PassNone
Observe Whatsappgokapso/agent-skills175—~1.8kAutomated safety check: PassNone
Loops APIopeninary/openinary412—~1.1kAutomated safety check: PassAGPL-3.0

Similar skills

  • 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
  • API Patterns

    dilolabs/nosia

    Builds REST APIs using respondto blocks with Jbuilder templates following the 37signals same-controllers-different-formats philosophy.

    213 GitHub starsUsed in 1 repo~2.5k tokens
    Backend & APIsAuto-check passed
  • 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.

    175 GitHub stars~4.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Observe Whatsapp

    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…

    175 GitHub stars~1.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Loops API

    openinary/openinary

    A skill your agent uses whenever the user wants to integrate Loops from application code, backend services, webhook handlers, or server-side automation.

    412 GitHub stars~1.1k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Verify

    gregluffy/HomeLabInfo

    Build, run, and drive the HomeLabInfo backend to verify changes at its real surfaces (REST API, UDP DHCP listener, outgoing webhooks).

    103 GitHub stars~424 tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from evolution-foundation/evo-nexus

All 117 skills in this repo
  • AI Image Creator

    evolution-foundation/evo-nexus

    Generates PNG images through OpenRouter models, with transparent backgrounds and reference-image edits, and describes existing images with multimodal vision.

    545 GitHub stars~5.1k tokensUpdated 4 mo ago
    Auto-check: notes
  • MongoDB Query Client

    evolution-foundation/evo-nexus

    Runs read-only MongoDB finds, aggregations and collection listings against databases named in your .env, choosing the connection by label or index.

    545 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check: notes
  • MySQL and MariaDB Query Tool

    evolution-foundation/evo-nexus

    Queries MySQL or MariaDB databases declared in .env by label, read-only by default unless a connection explicitly allows writes.

    545 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check: notes
  • Postgres Query Client

    evolution-foundation/evo-nexus

    Runs read-only SQL queries and schema exploration against PostgreSQL databases declared in .env, chosen by label or index, with writes blocked unless a connection allows them.

    545 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check: notes
  • Redis Inspector

    evolution-foundation/evo-nexus

    Reads keys and server state from Redis instances configured in .env through a read-only Python client, choosing connections by label or index.

    545 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check: notes
  • Int Bling

    evolution-foundation/evo-nexus

    Bling ERP integration via API v3. An agent skill from evolution-foundation/evo-nexus.

    545 GitHub stars~2.5k tokensUpdated 4 mo ago
    Auto-check: notes

Works with

Categories

Questions about Int Evolution API

What does Int Evolution API do?

Manage WhatsApp instances and send messages via the Evolution API. Int Evolution API is an agent skill from evolution-foundation/evo-nexus. Manage WhatsApp instances and send messages via the Evolution API.

When should I use Int Evolution API?

Int Evolution API fits situations like: you need to list/create/connect instances; send messages (text; query chats/contacts; configure webhooks.

How do I install Int Evolution API in Claude Code?

Run `npx skills add evolution-foundation/evo-nexus --skill int-evolution-api -a claude-code`. Or copy the skill folder (.claude/skills/int-evolution-api in evolution-foundation/evo-nexus) into .claude/skills/int-evolution-api in your project. Claude Code loads it when a task matches its description.

How do I install Int Evolution API in Codex?

Run `npx skills add evolution-foundation/evo-nexus --skill int-evolution-api -a codex`. Or copy the skill folder (.claude/skills/int-evolution-api in evolution-foundation/evo-nexus) into .agents/skills/int-evolution-api in your project. Codex loads it when a task matches its description.

Can I use Int Evolution API 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 evolution-foundation/evo-nexus --skill int-evolution-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/int-evolution-api, .gemini/skills/int-evolution-api, .github/skills/int-evolution-api and .opencode/skills/int-evolution-api in your project.

What does Int Evolution API need to run?

Going by SKILL.md and its folder, Int Evolution API needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named EVOLUTION_API_KEY. Our summary lists: Python 3; A credential in EVOLUTION_API_KEY.

Does Int Evolution API access the network?

SKILL.md names 1 domain. In commands or code: api.evolution-api.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Int Evolution API 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 Int Evolution API use?

Int Evolution API has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Int Evolution API use?

About 1.6k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Int Evolution API?

Skills that share tags, products or a category with Int Evolution API: Workspace API (friday-platform/friday-studio, 104 stars), API Patterns (dilolabs/nosia, 213 stars), Integrate Whatsapp (gokapso/agent-skills, 175 stars) and Observe Whatsapp (gokapso/agent-skills, 175 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Int Evolution API?

evolution-foundation (a GitHub organization) maintains it in evolution-foundation/evo-nexus, which has 545 GitHub stars. The repository holds 117 skills in this directory. The repository was last updated on May 13, 2026.

Source: evolution-foundation/evo-nexus on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.