Agent Skills for AI Coding Agents

SupportBee publishes Agent Skills - structured instruction sets that AI coding agents can discover and use automatically. When you install SupportBee's skills, your coding agent gains contextual knowledge about the SupportBee API, product features, and security practices. This means it can help you build integrations, configure your account, and write code against the SupportBee API with accurate, up-to-date guidance.

Agent Skills are supported by 35+ coding agents including Claude Code, Cursor, GitHub Copilot, VS Code Copilot, OpenAI Codex, Gemini CLI, Roo Code, and many more.

Installing SupportBee skills

Run the following command in your terminal:

npx -y skills add https://supportbee.com

You will be prompted to choose which skills to install and which agent to install them to. To skip the prompts and install everything:

npx -y skills add https://supportbee.com --all

Install to a specific agent

If you only use one coding agent, you can target it directly:

# Claude Code
npx -y skills add https://supportbee.com --agent claude-code --all

# Cursor
npx -y skills add https://supportbee.com --agent cursor --all

# GitHub Copilot
npx -y skills add https://supportbee.com --agent github-copilot --all

Install globally or per project

By default, skills are installed at the project level (in the current directory). To make them available across all your projects, add the -g flag:

npx -y skills add https://supportbee.com -g --all

Project-level skills are useful when you have a specific repository that integrates with SupportBee. Global skills are useful if you work with SupportBee across multiple projects.

Available skills

SupportBee publishes three skills:

supportbee-best-practices

Guides your coding agent through SupportBee setup and configuration decisions. Covers email setup, ticket workflows, users and permissions, customer management, knowledge base, customer portal, business hours, and account settings.

supportbee-api

Gives your coding agent knowledge of SupportBee's API endpoints, webhooks, and integrations. Use this when building custom workflows or writing code that talks to SupportBee.

supportbee-security

Provides your coding agent with details on SupportBee's security posture, GDPR compliance, data protection, and vulnerability disclosure policies.

You can install a specific skill if you don't need all three:

npx -y skills add https://supportbee.com --skill supportbee-api --all

How skills work

Skills use a three-tier loading strategy so your coding agent stays fast while having access to detailed knowledge when it needs it:

  1. Discovery - At startup, the agent loads only the skill name and description (about 50 words per skill). This is enough for the agent to know when a skill is relevant.

  2. Activation - When your task matches a skill's description, the agent loads the full instructions. For example, if you ask about webhooks, the agent loads the supportbee-api skill.

  3. Resources - The skill's instructions reference detailed documentation files. The agent loads these individually as needed, keeping context focused on what matters for your specific question.

This means installing all three skills has almost no cost until you actually need them.

Example use cases

Building a custom integration

Ask your coding agent to write code against the SupportBee API, and it will use the correct endpoints, authentication, and payload formats.

Prompt:

Write a Python script that fetches all unanswered tickets from SupportBee
and posts a daily summary to our Slack channel

The agent activates the supportbee-api skill and uses the API reference to write code with the correct authentication and endpoints:

import requests

SUPPORTBEE_TOKEN = "your_api_token"
SUPPORTBEE_DOMAIN = "your-company"
SLACK_WEBHOOK = "https://hooks.slack.com/services/..."

# Fetch unanswered tickets from SupportBee
resp = requests.get(
    f"https://{SUPPORTBEE_DOMAIN}.supportbee.com/tickets",
    headers={
        "Authorization": f"Bearer {SUPPORTBEE_TOKEN}",
        "Accept": "application/json",
    },
    params={"archived": "false", "spam": "false"},
)
tickets = resp.json().get("tickets", [])
unanswered = [t for t in tickets if not t.get("current_user_assignee")]

# Post summary to Slack
summary = f"*{len(unanswered)} unanswered tickets*\n"
for ticket in unanswered[:10]:
    summary += f"- {ticket['subject']} (#{ticket['id']})\n"

requests.post(SLACK_WEBHOOK, json={"text": summary})

Setting up webhooks programmatically

Prompt:

I need to trigger a GitHub Actions workflow whenever a new ticket
is created in SupportBee. How should I set this up?

The agent activates the supportbee-api skill, loads the webhooks reference, and walks you through the setup - explaining that SupportBee sends an HTTP POST for each event, what events are available (new ticket, new reply, ticket assigned, etc.), and how to configure the webhook URL in Admin.

Configuring email forwarding

Prompt:

We're migrating from Zendesk to SupportBee. How should we set up
email forwarding for our three support addresses?

The agent activates the supportbee-best-practices skill, loads the email setup reference, and provides step-by-step instructions for connecting Gmail or Outlook inboxes, setting up auto-responders per address, and configuring filters to route tickets to the right teams.

Writing a ticket automation script

Prompt:

Write a Node.js function that auto-labels tickets based on keywords
in the subject line using the SupportBee API

The agent uses the supportbee-api skill to generate code with the correct API calls:

const SUPPORTBEE_TOKEN = 'your_api_token';
const SUPPORTBEE_DOMAIN = 'your-company';
const BASE_URL = `https://${SUPPORTBEE_DOMAIN}.supportbee.com`;

const LABEL_RULES = {
  billing: ['invoice', 'payment', 'charge', 'refund', 'subscription'],
  bug: ['error', 'broken', 'not working', 'crash', 'bug'],
  feature: ['feature request', 'suggestion', 'would be nice', 'can you add'],
};

async function labelTicket(ticket) {
  const subject = ticket.subject.toLowerCase();

  for (const [label, keywords] of Object.entries(LABEL_RULES)) {
    if (keywords.some((kw) => subject.includes(kw))) {
      await fetch(`${BASE_URL}/tickets/${ticket.id}/labels/${label}`, {
        method: 'POST',
        headers: {
          Authorization: `Bearer ${SUPPORTBEE_TOKEN}`,
          Accept: 'application/json',
        },
      });
      console.log(`Labeled ticket #${ticket.id} as "${label}"`);
    }
  }
}

Security and compliance review

Prompt:

I need to document SupportBee's security practices for our vendor
assessment. What should I include?

The agent activates the supportbee-security skill and provides details on data protection, GDPR compliance, and the vulnerability disclosure program, with links to the relevant documentation.

Managing installed skills

List installed skills

npx skills list

Update to the latest version

SupportBee may update the skills as new features or API changes are released. To pull the latest:

npx skills update

Remove skills

# Remove a specific skill
npx skills remove supportbee-api

# Remove all SupportBee skills
npx skills remove supportbee-best-practices supportbee-api supportbee-security

Supported agents

SupportBee's Agent Skills work with any agent that supports the Agent Skills standard, including:

The full list of supported agents is available at agentskills.io.

Learn more