viralnote-skill

Drop-in skill pack for autonomous agents. Teaches an agent the ViralNote REST API so it can schedule posts, import media, query analytics, and manage social accounts — without you wiring up tool definitions by hand.

MIT-licensed and live on GitHub. For native MCP tool calls (15 tools) in Claude or Cursor, use the MCP server instead.

Install

Claude Code / Claude Desktop with the skills CLI:

npx skills add viralnote/viralnote-skill

Drops the skill into ~/.claude/skills/viralnote/. Restart your client so the agent can load it on demand.

Manual install

git clone https://github.com/viralnote/viralnote-skill ~/.claude/skills/viralnote

OpenClaw / ClawHub

clawhub install @viralnote/viralnote
export VIRALNOTE_API_KEY="vnd_..."

Published on ClawHub as @viralnote/viralnote. More agent setup at viralnote.app/agents.

Configuration

The skill calls the REST API with an API key. Set it in your agent environment:

export VIRALNOTE_API_KEY="vnd_..."

Generate a key in Settings → API keys. Grant posts:read and posts:write at minimum; add webhook scopes if your agent should manage subscriptions.

What it ships with

• • SKILL.md — when to use ViralNote, API basics, workflow patterns, and safety rules (confirm before publish/delete)
• • reference/ — endpoint reference and auth notes (loaded on demand)
• • examples/ — schedule a post, import media, pull analytics
• • MIT licensed — issues and PRs welcome on GitHub

Example prompts

Once installed, ask your agent in plain language:

• • “Schedule a post for tomorrow at 9am on Instagram and X with the photo in my library.”
• • “What were my best-performing posts on Pinterest in the last 30 days?”
• • “Import this file into my ViralNote library: https://…”

Skill vs MCP

• This skill — agent reads instructions and calls the REST API with curl or HTTP tools. Best for Claude skills, OpenClaw, and agents without MCP support.
• MCP server — 15 typed tools (create_post, list_analytics, etc.) discovered automatically. Best for Claude Desktop, Cursor, and MCP-native hosts. See /developers/mcp.

Full API reference: /developers/docs. OpenAPI spec: /api/v1/openapi.