Install the Sharedrop Skill

The sharedrop skill is a markdown instruction file that teaches an AI agent when and how to use Sharedrop — when to upload, sensible visibility defaults, how to keep a URL stable across re-uploads, and how to handle quota errors. The skill rides on top of the MCP server, which provides the actual tools.

Agents with a skills directory (one command)

Claude Code, OpenAI Codex, OpenClaw, Hermes, Cursor, OpenCode, and ~65 other agents are covered by the skills CLI. One command detects every agent installed on your machine and installs the skill globally for each:

npx skills add ShareDropCloud/skills --skill sharedrop -g

No npm? The fallback installer drops SKILL.md directly into each agent's global skills directory (~/.claude/skills/, ~/.codex/skills/, ~/.openclaw/skills/, ~/.hermes/skills/):

curl -fsSL https://sharedrop.cloud/skill.sh | bash

To install for a single project instead of globally, drop the -g flag, or download the file yourself:

mkdir -p .claude/skills/sharedrop
curl -fsSL https://sharedrop.cloud/sharedrop-skill.md -o .claude/skills/sharedrop/SKILL.md

The canonical skill source is published at sharedrop.cloud/sharedrop-skill.md and mirrored at github.com/ShareDropCloud/skills.

Claude Desktop / claude.ai (zip upload)

Claude Desktop and claude.ai take skills as a zip upload rather than a file on disk:

1. Download sharedrop-skill.zip.
2. In Claude Desktop or claude.ai, open Settings → Capabilities → Skills.
3. Upload the zip. The skill activates in new conversations.

Pair it with the MCP connector — add https://sharedrop.cloud/api/mcp as a remote MCP server under Settings → Connectors and complete the OAuth sign-in on first connect.

ChatGPT (MCP connector + instructions)

ChatGPT has no skill mechanism; its equivalent is a remote MCP connector plus project instructions:

1. In ChatGPT, open Settings → Connectors (developer mode) and add a custom connector pointing at https://sharedrop.cloud/api/mcp.
2. Complete the OAuth sign-in when prompted — no API key needed.
3. Paste this into your project's instructions so ChatGPT knows when to reach for it:

You have Sharedrop tools for sharing documents. Whenever you produce HTML, Markdown,
a PDF, or an image the user should see or hand to someone else, upload it to Sharedrop
and reply with the live URL. Call whoami once per session. Default visibility is
"private"; use "public" only when the user explicitly asks to publish. To update an
existing page, re-upload with the same page_id — the URL stays stable. To share with a
specific person, call share_with_email. Never invent a URL: surface the exact URL the
upload response returns, on its own line.

MCP configuration (all agents)

The skill assumes the Sharedrop MCP server is connected. Point any MCP-capable client at the remote endpoint — OAuth on first connect, or a Bearer API key:

{
  "mcpServers": {
    "sharedrop": {
      "type": "http",
      "url": "https://sharedrop.cloud/api/mcp",
      "headers": {
        "Authorization": "Bearer sd_your_api_key_here"
      }
    }
  }
}

Omit the headers block entirely if your client supports OAuth for remote MCP servers. Per-client snippets (Claude Desktop, Claude Code, Cursor, Windsurf, Codex) live in dashboard → settings → MCP; create API keys under settings → API keys.

Verify the install

1. Start your agent and ask: "What sharedrop tools do you have available?" — it should list upload_html, create_upload, share_with_email, whoami, and friends.
2. Ask it to "share a hello-world page with me" — it should upload and reply with a sharedrop.cloud URL.

If the tools are missing, the MCP server isn't connected (check the config above). If the tools work but the agent doesn't reach for them unprompted, the skill file isn't installed — re-run the install command for your agent.