This repository contains a customer-safe SKILL.md for using FlockPoster through the public CLI and public API.

It is intentionally limited to supported customer workflows:

• install flockposter-cli
• configure FLOCKPOSTER_API_KEY
• discover integrations and provider settings
• upload media
• create draft or scheduled posts
• handle platform-specific cases for X, TikTok, Instagram, and YouTube
• fetch analytics
• recover missing release IDs

npm install -g flockposter-cli

Verify installation:

flockposter --help

export FLOCKPOSTER_API_KEY=your_api_key_here

Optional for self-hosted instances:

export FLOCKPOSTER_API_URL=https://your-host.example.com/api

flockposter integrations:list

flockposter posts:create \
  -c "Hello from FlockPoster" \
  -s "2026-05-18T15:00:00Z" \
  -i "your-integration-id"

flockposter posts:list

The agent-facing skill includes exact examples and guardrails for:

• X posts, reply controls, communities, and threads
• TikTok direct posting and upload-without-posting flows
• Instagram posts, Reels, Stories, and Trial Reels
• YouTube uploads and Shorts

Ready-to-use examples are included inline in SKILL.md so the landing page SKILL.md clipboard button is self-contained.

• SKILL.md contains the agent-facing workflow and guardrails.
• README.md contains the human-facing quick start.
• examples/ contains the same customer-safe CLI and public API payload examples as standalone files.

• App: https://app.flockposter.com
• Docs: https://docs.flockposter.com
• npm: https://www.npmjs.com/package/flockposter-cli