instagram-poster

Publish Instagram carousels and Reels from local media folders.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/GavinTPA/ai-powerhouse-starter --skill instagram-poster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instagram-poster
Source: https://github.com/GavinTPA/ai-powerhouse-starter/tree/main/my-skills/instagram-poster
Command: npx skills add https://github.com/GavinTPA/ai-powerhouse-starter --skill instagram-poster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, pyyaml.

What problem does it solve?

This Skill removes the manual, error-prone steps of uploading media, creating containers, and publishing Instagram carousels and Reels by automating staging, container creation, publishing, and cleanup so creators can publish directly from local files.

Core Features & Use Cases

  • Carousel and Reel publishing: Post 2–10 image carousels and 5–90 second Reels via the Meta Graph API.
  • Automated staging and cleanup: Uploads media to Vercel Blob for temporary public URLs and deletes staged files after publishing.
  • OAuth and token lifecycle management: One-time setup wizard, long-lived 60-day tokens, auto-refresh when used regularly, and manual refresh tooling.
  • Caption templating: Render captions from named templates with variables for title, topic, and CTA to standardize copy.
  • Use case: After generating a carousel locally, run the wizard once to connect your account, then publish images and a templated caption directly to your Instagram business account.

Quick Start

Say "post this carousel to Instagram" after placing 2–10 PNG images in a folder under ~/Downloads and confirming the interactive approval prompt.

Frequently Asked Questions about instagram-poster

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

FAQPage Schema
How do I automate publishing Instagram carousels and Reels from local files?

To automate Instagram publishing from local files, use a Skill that stages media to Vercel Blob and publishes 2–10 image carousels or 5–90 second Reels via the Meta Graph API. It handles container creation, templated captions, and cleanup automatically.

What do I need to set up before posting Instagram media through the Meta Graph API?

Before posting Instagram media through the Meta Graph API, you need Meta App credentials, a Vercel Blob read/write token, and an OAuth long-lived access token stored locally. A one-time setup wizard generates and saves this configuration.

How does OAuth token management work for automated Instagram posting?

OAuth token management for automated Instagram posting uses long-lived 60-day tokens that auto-refresh when used regularly. The Skill also provides manual refresh tooling to maintain access for recurring publishing workflows.

Can I post Reels between 5 and 90 seconds directly from a macOS folder?

Yes, you can post Reels between 5 and 90 seconds directly from a macOS folder. The Skill automates media staging, container creation, and publishing by uploading local files to temporary public URLs before publishing.

Are staged media files deleted after publishing an Instagram carousel?

Yes, staged media files are deleted after publishing an Instagram carousel. The Skill uploads local media to Vercel Blob to generate temporary public URLs required by the Meta Graph API, then automatically cleans up these files.

How do I standardize captions for Instagram carousels and Reels?

You standardize captions for Instagram carousels and Reels using caption templating. The Skill renders captions from named templates with variables for title, topic, and CTA, ensuring consistent copy across all published media.