Skip to main content
Courier Skills is an open, structured set of guidance that AI coding agents read before they build notifications with Courier. Install it once and your agent stops guessing: it finds the right Courier APIs, SDKs, and patterns for the task, picks the channel that fits the message, and gets the send right the first time. Deliverability and compliance rules come along for free.

​
Why Use It

Left alone, an agent guesses. It reaches for an API that doesn’t exist, picks whatever channel comes to mind, and you catch it in review. Courier Skills points your agent at the right content up front so it builds the right thing.

Without it

The agent invents Courier API calls, picks a channel at random, and leaves you to untangle it in review.

With it

The agent pulls Courier’s real APIs, SDKs, and patterns, picks the channel that fits the message, and gets the send right the first time.

​
Works With Any Agent

Courier Skills is plain Markdown on the open agent-skills convention, so it is not tied to one vendor. Claude Code, Cursor, Codex, Windsurf, Cline, and anything else that reads a skills directory or a SKILL.md can use it. Install once per tool and every project picks up the same guidance.

​
Installation

Works with Cursor, Claude Code, Codex, and any tool that supports agent skills:
Discovery is driven by the name and description frontmatter in each SKILL.md, with no extra configuration.

​
What It Covers

Every channel

Email, SMS, push, in-app inbox, Slack, Microsoft Teams, and WhatsApp, each with its own deliverability and formatting rules.

Transactional messages

OTP and password reset, order and billing updates, appointments, and account alerts, with the timing and security rules each one needs.

Growth messages

Onboarding, adoption, engagement, re-engagement, referral, and campaigns, with consent, frequency caps, and exit conditions built in.

Getting it right

Multi-channel routing, preferences, reliability, batching, and throttling, plus GDPR / TCPA / CAN-SPAM compliance when you need it.

​
How It Works

A routing file (SKILL.md) the agent reads first maps each task to the one or two guides that matter, so it loads only what it needs instead of the whole skill.
1

Read the router

The agent opens SKILL.md and finds the routing table that maps tasks to guides.
2

Load only what matters

Building an OTP flow? The router points to authentication.md and sms.md, and nothing else loads.
3

Apply the rules

Those guides carry the hard rules and defaults: 6-digit codes, 5-10 minute expiry, SMS-primary with email fallback, idempotency keys, and rate limits.
4

Write the send

The generated code follows every constraint, so you review something that works instead of correcting a first draft.
Each guide leads with a quick reference of hard rules and common mistakes, then detailed guidance below. Your agent gets the minimum context it needs and no more.

​
FAQ

Any agent that supports the agent-skills convention: Claude Code, Cursor, Codex, Windsurf, Cline, and anything else that reads a skills directory or a SKILL.md file. The skill is plain Markdown, so it is not tied to a single tool.
No. It is a free, public repository on GitHub. Install it with npx skills add trycourier/courier-skills or clone it directly.
Skills teach your agent how to build notifications: channel choice, compliance, and reliability best practices. The MCP server gives your agent tools to call the Courier API directly. They work well together.
You need a Courier account and API key to send notifications, but not to install the skill or read its guidance.