skills.rest
akhy
akhyCOMMUNITY
Explore all skills by this author →
Website𝕏@akhyGitHub

buffer

Create, schedule, and manage Buffer social media posts and ideas via the Buffer GraphQL API.

1|Updated Mar 3, 2026
Search Tags:#social media#api#graphql#scheduling#buffer#content ideas#post queue
One-click install
npx skills add https://github.com/akhy/agent-skills --skill buffer-akhy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: buffer
Source: https://github.com/akhy/agent-skills/tree/main/buffer
Command: npx skills add https://github.com/akhy/agent-skills --skill buffer-akhy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve? Managing social media publishing across multiple platforms requires switching between dashboards and manual scheduling. This Skill lets you create, schedule, queue, and draft Buffer posts and ideas directly from the command line through Buffer's GraphQL API. ## Core Features & Use Cases - Post Management: Create posts with multiple scheduling modes (addToQueue, shareNow, shareNext, customScheduled, recommendedTime), save drafts, and list or filter posts by status and channel. - Idea Creation: Capture content ideas in the Buffer Create space with titles, body text, target dates, and tags. - Multi-Platform Support: Works with all Buffer-connected services including Instagram, Twitter/X, Facebook, LinkedIn, TikTok, Pinterest, YouTube, Mastodon, Bluesky, and Threads. - Use Case: Schedule a product launch announcement across your LinkedIn and Twitter channels at a specific time by fetching your org ID, listing channels, and running create-post with customScheduled mode. ## Quick Start Set the BUFFER_API_KEY environment variable, then ask the agent to schedule a post saying "Hello world" to your Buffer channel queue.

Frequently Asked Questions about buffer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule a Buffer post from the command line?▼

Run buffer.sh create-post with --channel-id, --text, --mode customScheduled, and --due-at set to an ISO 8601 datetime. First get your org ID with the account command, then list channels to find the target channel ID.

How to post to multiple social networks with Buffer API?▼

Buffer connects services like Instagram, Twitter/X, LinkedIn, TikTok, and Mastodon as channels. Create a separate post per channel ID using create-post, since each Buffer post targets one channel through the GraphQL API.

Can I edit an existing Buffer post via the API?▼

Buffer's public GraphQL API does not expose an updatePost mutation. The update-post command creates a revised draft instead, or you can edit the post directly in the Buffer dashboard.

What credentials does the Buffer API script need?▼

The script requires the BUFFER_API_KEY environment variable containing your Buffer API key from account settings. It also requires curl and jq installed in your PATH, and optionally accepts BUFFER_API_URL to override the API base URL.

Why does my Buffer post creation fail with GraphQL errors?▼

Failures typically come from a missing or invalid BUFFER_API_KEY, an incorrect channel ID, or missing --due-at when using customScheduled mode. The script prints GraphQL error details to stderr to help identify the cause.

Related Skills

Explore More Marketing & Sales Skills→
wrocppwrocpp

push-to-buffer

Create Buffer drafts for LinkedIn and Facebook from a wro.cpp post slug.

Official
Advanced
bingran-youbingran-you
3

content-calendar

Create repeatable Xiaohongshu content calendars with posting frequency and weekly themes.

Community
Intermediate
rzredpandarzredpanda

caption-writer

Generate Instagram captions and hashtags saved to caption.txt and hashtags.txt.

Community
Intermediate
capaas2capaas2

blotato

Publish and schedule social media posts across multiple platforms via the Blotato MCP API.

Community
Intermediate