# OneSignal agent skills for Claude Code, Cursor and RevampKey

> Ready-made OneSignal playbooks for AI agents: review OneSignal segments before you send, audit past OneSignal messages, analyse OneSignal engagement from an export. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the OneSignal connector safely](https://revampkey.com/marketplace/onesignal/skills/essentials.md): Teaches an AI assistant how to work with OneSignal: confirm the app first, read before changing anything, and ask for explicit approval before any message is sent or any segment, subscription or alias is changed.
- [Review OneSignal segments before you send](https://revampkey.com/marketplace/onesignal/skills/audience-segment-review.md): Audits your existing OneSignal segments for stale campaign leftovers, overlapping audiences and broad or fragile targeting before anyone sends to them. It only reads segments and never changes one without your explicit yes.
- [Audit past OneSignal messages](https://revampkey.com/marketplace/onesignal/skills/campaign-message-audit.md): Reviews your OneSignal message history and templates as a read-only retrospective, flagging messages with no template, unclear audiences or off-window sends. It only reads data and never changes or resends anything.
- [Analyse OneSignal engagement from an export](https://revampkey.com/marketplace/onesignal/skills/engagement-export-analysis.md): Turns your OneSignal audience activity export into a clear engagement summary covering active versus dormant users, channel mix and opt-out trend. It reports with sample-size caveats and never sends or changes anything.
- [Reconcile OneSignal subscriptions and identities with AI](https://revampkey.com/marketplace/onesignal/skills/subscription-data-reconciliation.md): Matches OneSignal subscriptions and user identities against your source list, finds duplicates and wrong links, and drafts a change plan. It asks before changing any record.

## Install

- RevampKey: connect OneSignal at https://revampkey.com/marketplace/onesignal; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
for s in essentials audience-segment-review campaign-message-audit engagement-export-analysis subscription-data-reconciliation; do
  curl -fsSL --create-dirs -o .agents/skills/onesignal-$s/SKILL.md https://revampkey.com/marketplace/onesignal/skills/$s/SKILL.md
done
```

### What is a OneSignal agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each OneSignal skill describes one job, which OneSignal tools to use in which order, what to check first and when to stop and ask you.

### Do the OneSignal skills change anything on their own?

2 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in OneSignal.

### Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect OneSignal; elsewhere you copy the folders into your project or skills directory.

### Do I need the OneSignal MCP server too?

Yes. The skills tell the agent how to do the work; the OneSignal MCP server gives it the tools to do it. The OneSignal MCP setup guide covers every client.

MCP setup guide: https://revampkey.com/marketplace/onesignal.md
