Using with Cursor

Cursor has native support for the AgentSkills standard. Skills installed via npx skills add are automatically discovered by Cursor Agent — no manual configuration needed.

How it works in Cursor

Cursor Agent loads skills from these directories and presents them as available capabilities:

Location	Scope
`.cursor/skills/<skill-name>/`	Current project only
`.agents/skills/<skill-name>/`	Current project only
`~/.cursor/skills/<skill-name>/`	All projects (global)
`~/.agents/skills/<skill-name>/`	All projects (global)

When a skill is installed, Agent reads its SKILL.md file and automatically decides when to apply it based on what you ask. You can also invoke any skill explicitly by typing /skill-name in the Agent chat. Skills are visible in Cursor Settings → Rules → Agent Decides.

Install the skills

Global install (recommended)
Project-level install
Install a single skill

Installs the skills for all your projects. Run once:

npx skills add whatsable/whatsapp-business-agent-skills -g

This puts all 3 skills under ~/.agents/skills/:

~/.agents/skills/setup-notifyer/
~/.agents/skills/automate-notifyer/
~/.agents/skills/chat-notifyer/

Installs only into the current project’s .agents/skills/ directory:

npx skills add whatsable/whatsapp-business-agent-skills

When prompted, select the skills you want, or select All 3 skills to install everything at once.

npx skills add whatsable/whatsapp-business-agent-skills --skill setup-notifyer
npx skills add whatsable/whatsapp-business-agent-skills --skill automate-notifyer
npx skills add whatsable/whatsapp-business-agent-skills --skill chat-notifyer

The scripts in these skills are Node.js CLI tools that run in your terminal, not inside Cursor’s chat UI. Cursor Agent reads the skill instructions and executes scripts using its terminal tool when needed.

Set up environment variables

The scripts need two variables before Agent can use them:

export NOTIFYER_API_BASE_URL="https://api.insightssystem.com"
export NOTIFYER_API_TOKEN="eyJ..."   # obtained via setup-notifyer/scripts/login.js

Add these to your shell profile (~/.zshrc or ~/.bashrc) so they’re always available when Cursor’s terminal runs scripts. Alternatively, add a .env file to your project — Cursor Agent can read it if you reference it in your prompt.

Never commit NOTIFYER_API_TOKEN to Git. The .gitignore in the agent-skills repo already excludes .env and .env.* files.

For full environment variable reference, see Auth & environment.

Verify discovery

After installing, confirm Cursor can see the skills:

Open Cursor Settings → Rules
Look for setup-notifyer, automate-notifyer, and chat-notifyer in the Agent Decides section

Or run in Cursor Agent chat:

/setup-notifyer

Agent will display the skill instructions and confirm it’s loaded.

Example Agent prompts

Once installed, use natural language in Cursor Agent chat. Agent will identify the relevant skill and execute the appropriate scripts.

Workspace setup

Log in to Notifyer with email=me@company.com and run a full health check.
Tell me if the WhatsApp connection is active and what plan we're on.

Create three labels: Sales, Support, and VIP.
For each one, set up relevant keywords (e.g. "pricing, quote" for Sales).

Template management

List all our approved WhatsApp templates and show me which ones have variables.

Create a new template called order_shipped in the UTILITY category.
Body: "Hi {{1}}, your order {{2}} has shipped and will arrive by {{3}}."

Live chat operations

Find all unread conversations labeled VIP and show me the full context for each one.

Check if the 24-hour messaging window is open for +14155550123, then send them
"Hi! Just following up on your recent enquiry." if it is.

Assign the Support label to +14155550123, take over from the bot, and add a note:
"Customer escalated — awaiting approval from billing team."

Broadcast campaigns

Create a broadcast called Feb Promo using template ID 42.
Test it on +14155550123 first, then schedule it for 01/02/2026 at 10:00.

Manually invoking a skill

If Agent doesn’t pick up a skill automatically, invoke it with the / command:

/setup-notifyer Run doctor.js and tell me what's wrong.

/chat-notifyer Get the last 20 messages from the conversation with +14155550123.

/automate-notifyer List all webhooks and show me which ones have signatures enabled.

How Agent runs the scripts

When you give Agent a task, it:

Reads the relevant SKILL.md to understand available scripts and their flags
Opens a terminal in the skill’s directory (skills/setup-notifyer/, etc.)
Runs the script with the correct flags
Parses the JSON output (ok/err structure) and summarises the result

All scripts output structured JSON, which Agent can read and act on — for example, it can check if isConnected: false and automatically suggest running refresh-connection.js.

Keeping skills up to date

# Re-run the install command to pull the latest version
npx skills add whatsable/whatsapp-business-agent-skills -g

Get Started

Notifyer System

WhatsAble

How it works in Cursor

Install the skills

Set up environment variables

Verify discovery

Example Agent prompts

Workspace setup

Template management

Live chat operations

Broadcast campaigns

Manually invoking a skill

How Agent runs the scripts

Keeping skills up to date

​How it works in Cursor

​Install the skills

​Set up environment variables

​Verify discovery

​Example Agent prompts

​Workspace setup

​Template management

​Live chat operations

​Broadcast campaigns

​Manually invoking a skill

​How Agent runs the scripts

​Keeping skills up to date

​Related pages

How it works in Cursor

Install the skills

Set up environment variables

Verify discovery

Example Agent prompts

Workspace setup

Template management

Live chat operations

Broadcast campaigns

Manually invoking a skill

How Agent runs the scripts

Keeping skills up to date

Related pages