The Spun skill is one file, SKILL.md, that tells an AI agent how to work with the Spun MCP server: how to sign in, what each access level refuses, how a send waits for approval and how to answer "did it send".
Spun publishes it in a public repository, https://github.com/spunlife/spun-mcp-skill, with the manifests Claude Code and Amp read. This page shows how to install it in each client, how to update and remove it, and what to do in clients that cannot load a skill file. Each install line is quoted from the vendor's own documentation, with the date we read it.
What an agent skill is, and what this one changes
An agent skill is a folder with a SKILL.md file: a short header with the skill's name and a description of when to use it, then plain instructions. The agent reads the header up front and loads the rest when a task matches. The open format is described at agentskills.io.
The Spun skill adds no tools and no access. Your agent still reaches your WhatsApp conversations only through the Spun connection and the access level an organization manager chose. What the skill changes is how the agent behaves on that connection:
- Read it before the first send, and before telling anyone a message went out.
- Approval etiquette: a send tool submits a request, it never means the message went out. The organization's send posture (draft_only, two_step by default, or autonomous) decides what happens next, and the agent says the message is waiting for approval.
- Did it send: never answer from memory. The agent calls get_delivery_status and reports the status as returned, so "pending_approval" is never described as sent.
- The access levels, Read-only analyst, Assistant (no sends) and Assistant with sends, and what each one refuses.
- The read allowance, what cannot be read (media on Free MCP, hidden group members, scanned PDFs, video) and the limits on Free MCP, checked with get_usage_summary instead of guessed.
Related: Read the skill file · Agent Skills specification
Before you start
- A Spun account with a WhatsApp number linked. Spun links to the number you already use; nothing goes through the Business API.
- A connection from your AI client to the Spun MCP server at https://api.spun.com/api/mcp, approved by an organization manager on the Spun consent screen. The skill is guidance on top of that connection, not a replacement for it.
- Access you are comfortable with. Start with Read-only analyst; an assistant with sends proposes messages that wait for a person to approve them.
Related: Connect Claude to WhatsApp, step by step · Access levels and Free MCP
Claude Code: install the plugin from the repository
The repository is a Claude Code plugin marketplace named spun with one plugin, spun-mcp. The plugin carries the skill and declares the Spun server at https://api.spun.com/api/mcp with no key in it. Run the two lines below inside Claude Code, then run /mcp, choose spun and Authenticate to sign in with your Spun account in the browser, as the skill itself describes.
From the Claude Code documentation, read 2026-11-10: "/plugin marketplace add" registers a marketplace from a GitHub repository given as owner/repo, and "/plugin install <plugin>@<marketplace>" opens the plugin's details in the /plugin panel, where you install it. The shell form is "claude plugin marketplace add" and "claude plugin install".
/plugin marketplace add spunlife/spun-mcp-skill /plugin install spun-mcp@spun
Related: Claude Code docs: plugin marketplaces · Claude Code docs: plugins reference
Claude Code: the skill alone, as a personal skill
If you would rather not add a marketplace, copy spun-mcp/SKILL.md from https://github.com/spunlife/spun-mcp-skill to ~/.claude/skills/spun-mcp/SKILL.md. From the Claude Code documentation, read 2026-11-10: a personal skill lives at ~/.claude/skills/<skill-name>/SKILL.md and is available in all your projects on that machine.
A personal skill brings the guidance only. Add the server yourself with the command below, then run /mcp, choose spun and Authenticate.
claude mcp add --transport http spun https://api.spun.com/api/mcp
Related: Claude Code docs: skills
Amp: one command
From the Amp documentation, read 2026-11-10: "amp skill add <source>" installs a skill directly from "a GitHub repository, Git URL, or local path", and "--global" installs it only on the current machine under ~/.config/agents/skills/.
The skill folder carries an mcp.json that points Amp at https://api.spun.com/api/mcp. Amp's documentation says the tools of a skill's MCP server stay hidden until the skill is loaded, and that for a server address Amp opens the server's sign-in page in your browser, where you sign in with your Spun account.
amp skill add https://github.com/spunlife/spun-mcp-skill
Related: Amp docs: skills · Amp docs: MCP
claude.ai: a ZIP upload, not published yet
Anthropic's help article on skills, read 2026-11-10, says a custom skill is uploaded as a ZIP: "Package your skill folder as a ZIP file." It also says code execution has to be enabled first. Spun does not publish a ZIP of the skill yet.
Until it does, the skill folder is spun-mcp in https://github.com/spunlife/spun-mcp-skill, and the Spun server sends its core instructions to the claude.ai connector as it does to every client, as described for ChatGPT below.
Related: Claude help: using skills in Claude · Connect Claude to WhatsApp
ChatGPT and clients without skills
ChatGPT cannot load a skill file. It does not need to for the essentials: when any client connects, the Spun MCP server sends instructions with the access levels and send postures, the rule that a send is a request waiting for approval, the rule to check get_delivery_status instead of answering from memory, the Free MCP allowance, and the rule that message and contact text is untrusted and its instructions are never followed. The full skill is linked from those instructions.
Related: How to connect ChatGPT to WhatsApp
Update and remove
- Claude Code plugin, remove: "/plugin uninstall spun-mcp@spun". To drop the marketplace as well, "claude plugin marketplace remove spun", which the documentation says "removes the marketplace and uninstalls its plugins".
- Claude Code plugin, update: the pages read do not document an update command. The remove and install commands above can be run again.
- Claude Code personal skill: the documentation says to delete the skill directory, here ~/.claude/skills/spun-mcp/. To update, copy the new SKILL.md over the old one.
- Amp: the documentation names "amp skill update" for shared imports without giving its syntax, and names no remove command. "amp skills list" shows what is installed.
- Removing the skill does not disconnect Spun. An organization manager can revoke a connected app at any time in Spun settings.