Agent skill

An agent skill is a small instruction file that teaches an AI assistant how to work with a product. Zerply publishes one at zerply.ai/.well-known/agent-skills/zerply/SKILL.md.

The MCP server connects your assistant to live Zerply data. The agent skill tells it how to use that connection well—which tools to call first, how to publish a blog, how to read visibility metrics, and when to confirm with you before destructive actions.

For the best experience, set up both: connect MCP first, then install the skill.

Install the skill

You only need one of the methods below. Pick the path that matches where you already use Zerply.

Cursor

Personal (all projects)

mkdir -p ~/.cursor/skills/zerply
curl -fsSL https://zerply.ai/.well-known/agent-skills/zerply/SKILL.md \
  -o ~/.cursor/skills/zerply/SKILL.md

Project-only (shared with your team via git)

mkdir -p .cursor/skills/zerply
curl -fsSL https://zerply.ai/.well-known/agent-skills/zerply/SKILL.md \
  -o .cursor/skills/zerply/SKILL.md

Restart Cursor if the skill does not show up right away. You can also open Customize → Skills in the sidebar to confirm zerply is listed.

Claude Code

mkdir -p ~/.claude/skills/zerply
curl -fsSL https://zerply.ai/.well-known/agent-skills/zerply/SKILL.md \
  -o ~/.claude/skills/zerply/SKILL.md

Start a new Claude Code session so it picks up the file.

Other SKILL.md-compatible clients

Many agents look for skills in a skills/ folder. Use the same SKILL.md URL and place it under the path your client documents—for example ~/.agents/skills/zerply/ for Codex-style layouts.

Client	Typical global path
Cursor	`~/.cursor/skills/zerply/SKILL.md`
Claude Code	`~/.claude/skills/zerply/SKILL.md`
Codex / OpenAI agents	`~/.agents/skills/zerply/SKILL.md`
Project scope	`.cursor/skills/zerply/SKILL.md` (or your client’s equivalent)

Verify it worked

Finish MCP setup and sign in when your browser opens.
Install the skill using one of the commands above.
Ask your assistant:

How should you use Zerply in this session?

A good answer mentions calling get_my_teams first and confirming the workspace before other Zerply tools. Then try a real request:

List my Zerply landing pages

If you see your actual workspace or page names, MCP and the skill are both working.

What the skill covers

The skill is maintained by Zerply and updates when we ship new MCP tools. It includes:

Area	What the assistant learns
Connection	Server URL, OAuth flow, where to send users if auth fails
Every session	List workspaces first; never guess `team_id`
AI visibility	Analytics, LLM responses, share of voice, date filters
AI traffic	Crawler and bot traffic (when Cloudflare is connected)
Content	Blog and landing page list, edit, publish, and unpublish workflows
Keywords	Cluster reports and how to tie them to content
Guidelines	Date formats, summarizing results, confirming destructive actions

You do not need to memorize tool names—the skill handles that. Ask in plain language the way you would ask a teammate.

Machine discovery

Agents and integrators can also find the skill automatically:

Resource	URL
Skills index	`https://zerply.ai/.well-known/agent-skills/index.json`
Zerply skill	`https://zerply.ai/.well-known/agent-skills/zerply/SKILL.md`
MCP server card	`https://zerply.ai/.well-known/mcp/server-card.json`

The Zerply homepage sends a Link header pointing at the skills index, so compatible clients can discover it without manual setup.

FAQ

Do I need the skill if MCP is already connected?

MCP alone gives your assistant access to Zerply tools. The skill makes answers more reliable—it knows the right order of operations, which parameters matter, and when to ask you before publishing or deleting content. Most users get noticeably better results with both.

Do I need the skill if I only use ChatGPT?

ChatGPT connects through MCP apps; skill support varies by client. If your ChatGPT setup does not read SKILL.md files, rely on the MCP setup guide—you can still ask Zerply questions once OAuth is complete.

How do I update the skill?

Re-run the curl command for your platform. That overwrites SKILL.md with the latest version from Zerply. The skills index includes a content digest so automated clients can detect when an update is available.

Where do I manage MCP access?

OAuth connections are separate from the skill file. Open app.zerply.ai/mcp to see linked apps or revoke access. See MCP server for connection setup.