Claude Instagram Skill

What this skill teaches the LLM

The skill is a markdown file the LLM reads when activating. Below is the focused context this skill bakes in — so Claude/ChatGPT/Cursor doesn't have to learn from API errors.

• Reel format requirements: 9:16 vertical, max 90 seconds via API (UI allows 3 min), MP4 H.264/AAC, max 100 MB
• Carousel rules: 2-10 items, same aspect ratio for every item (mixed ratios get rejected with media_type_required)
• Custom Reel cover via instagram_cover_url (1080×1920 portrait recommended) — NOT instagram_thumbnail_url
• Account requirements: Business or Creator only (Personal cannot post via API), must be linked to FB Page
• Stories cannot be scheduled via API — only Reels, carousels, and feed posts
• Per-platform media override (instagram_media_urls) for different aspect ratios than other platforms
• Collaborator invites (up to 3 usernames), geotagging via instagram_location_id, alt text for accessibility
• Rate limit handling: Meta caps at 200 calls/hour per Page (CodivUpload auto-defers if hit)

Install in 2 steps

The skill itself is a markdown file. The MCP server is the runtime. Install both for the full experience.

1. 1Configure MCP server in your AI client

   Paste this configuration into Claude Desktop / Cursor / Zed's MCP config file. Replace cdv_your_api_key with your real key from pricing.

   {
     "mcpServers": {
       "codivupload": {
         "command": "npx",
         "args": ["-y", "codivupload-mcp"],
         "env": {
           "CODIVUPLOAD_API_KEY": "cdv_your_api_key"
         }
       }
     }
   }

2. 2Add the skill markdown

   Download npmjs/skills/instagram/SKILL.md from the GitHub repo and place it under ~/.claude/skills/codivupload-instagram/SKILL.md (Claude Desktop) or your project's .claude/skills/ directory.

   For ChatGPT: paste the SKILL.md content into a Custom GPT's Instructions field at gpts.openai.com/editor.

   github.com/Codivion

Related skills