Postey Skills

AI agent skills for drafting, scheduling, and managing social media posts across X, LinkedIn, Instagram, TikTok, YouTube, Threads, and Bluesky.

Installation

Claude Code (recommended)

Step 1 — Register the marketplace (one-time per user):

/plugin marketplace add posteyai/skills

Step 2 — Install the skill:

/plugin install postey@postey-skills

Or for teams — add this to your project's .claude/settings.json and team members get prompted automatically when they trust the folder:

{
  "extraKnownMarketplaces": {
    "postey-skills": {
      "source": { "source": "github", "repo": "posteyai/skills" }
    }
  }
}

Other installation methods

Cursor / Windsurf / generic agents (npx):

npx skills add posteyai/skills

Manual:

Clone this repository and copy skills/postey/ to your project's .claude/skills/ or equivalent skills directory.

Alternative — Postey MCP Server (Claude Code):

For native MCP tool access without a CLI, connect the Postey MCP server directly at https://app.postey.ai?settings=integrations — no skill file needed.

Setup

1. Get your API key

Copy an existing key or create a new one at https://postey.com/?settings=api

2. Run setup

./skills/postey/scripts/postey.js setup

Or set the environment variable (zero additional commands if already set):

export POSTEY_API_KEY=your_key_here

3. Start using it

Ask your AI agent things like:

• "Draft a tweet about [topic]"
• "Create a LinkedIn post announcing [news]"
• "Schedule my draft for tomorrow morning"
• "Show my scheduled posts"
• "Cross-post this to Instagram, TikTok, and YouTube"
• "Upload this video and create captions for Instagram"

Supported Platforms

Platform	Notes
X (Twitter)	280 chars
LinkedIn	3,000 chars
Instagram	Reels + feed posts
TikTok
YouTube	Title required
Threads	500 chars
Bluesky	300 chars

Troubleshooting

"POSTEY_API_KEY environment variable is not set"

Run the setup command:

./skills/postey/scripts/postey.js setup

Or set the environment variable and add it to your shell profile (~/.bashrc, ~/.zshrc, etc.):

export POSTEY_API_KEY=your_key_here

"Node.js is required"

The CLI requires Node.js 18+ (for built-in fetch). Install a recent Node.js version, then retry.

API errors (401, 403)

• Verify your API key is correct
• Check that your key has the required permissions at https://app.postey.ai?settings=api

Drafts not appearing

• Run ./skills/postey/scripts/postey.js social-sets:list to verify your account ID
• Check draft status with ./skills/postey/scripts/postey.js drafts:list <social_set_id>

Links

• Postey
• API Docs
• Skills Leaderboard

License

MIT