Surfer Skills

Skills for using Surfer in your AI assistant: write and optimize articles, create outlines and briefs, manage templates, and act on content recommendations. Connect through Surfer MCP.

This repository is where the playbooks are maintained. The Surfer MCP server serves the same skills to every connected assistant, so a change merged here reaches the server as well. Install from here when your client does not read server-shipped skills, or when you want a pinned local copy.

• A Surfer account on a plan that includes MCP: Pro, Peace of Mind, Enterprise, or AI Search Analytics. The MCP tab in the app shows whether yours does.
• Creating a Content Editor and opening a recommendation consume Surfer credits. Enterprise and some older plans also consume an AI Article credit when generating an article; other plans include AI Articles in the Content Editor. Running Auto-Optimize counts toward your plan's Auto-Optimize allowance. Reading data costs nothing. See credits and limits.
• For the install command below, Node.js 22.20 or newer.

For ChatGPT and Codex plugins, download the versioned ZIP from the latest release. It bundles the same skills/ directory and the Surfer MCP connection in mcp.json.

Use the skills CLI in your project:

# All skills, including connection setup
npx skills add surferseo/skills --skill '*' -y

# One workflow, when Surfer is already connected
npx skills add surferseo/skills --skill surfer-create-outline -y

# Later, pull the latest playbooks
npx skills update

Add -a codex or -a claude-code to install for one assistant only. Without the CLI, copy a skills/<name> folder into .claude/skills/ for Claude Code or .agents/skills/ for Codex.

Ask your assistant to use surfer-connect for account setup, client-specific instructions, and connection problems. If you installed only a workflow, add surfer-connect when you need setup help. The Surfer MCP security page explains what a connected assistant can read, change, and delete.

Try: “Create a Surfer outline for best trail running shoes. Stop after the outline.”

For account help, visit the Surfer help center. MIT licensed; see LICENSE.