upload-post — Claude Code skill: post to social media via API
A skill that lets your agent publish videos, photos, text and documents to social platforms through the Upload-Post API. Useful when content should go out without you touching a dashboard.
npx skills add Upload-Post/upload-post-skill --skill upload-post -a claude-codeWhat upload-post does
The skill is a reference for the Upload-Post API. One call pushes content to several platforms at once, and the file lists every endpoint with request examples and auth rules, so the agent builds the calls itself instead of you pasting curl commands.
TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Reddit and Bluesky are covered. Video goes through /upload, photos and carousels through /upload_photos, text through /upload_text, and documents only to LinkedIn. Scheduling uses scheduled_date in ISO-8601 plus timezone; async jobs are tracked by request_id. There is upload history, per-profile analytics, and media processing through FFmpeg with {input} and {output} placeholders.
You need an Upload-Post account first: connect the social accounts, create a profile, generate an API key. Watch the user parameter — it takes the profile name, not your social handle, and mixing them up is the easy mistake here. The key travels in the Authorization: Apikey YOUR_API_KEY header, so keep it out of the repo.
What it helps with
- push one video to TikTok and Instagram at once
- schedule a post for a specific time
- build an Instagram carousel from photos and video
- publish a PDF as a LinkedIn document post
- pull follower and reach numbers for a profile
Example prompts for the agent
- Post video.mp4 to TikTok and Instagram with the caption "New clip"
- Schedule a LinkedIn post for 2026-02-01T10:00:00Z in Europe/Madrid
- Show my upload history, first page
How to install upload-post
1Skills CLI (Vercel)
npx skills add Upload-Post/upload-post-skill --skill upload-post -a claude-code2Manually: put the files in place
~/.claude/skills/upload-post/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/upload-post/
1Skills CLI (Vercel)
npx skills add Upload-Post/upload-post-skill --skill upload-post -a codex2Manually: put the files in place
.agents/skills/upload-post/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Upload-Post/upload-post-skill --skill upload-post -a cursor2Manually: put the files in place
.cursor/skills/upload-post/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Upload-Post/upload-post-skill upload-post2Manually: put the files in place
.github/skills/upload-post/SKILL.md1Skills CLI (Vercel)
npx skills add Upload-Post/upload-post-skill --skill upload-post -a gemini-cli2Platform CLI
gemini skills install https://github.com/Upload-Post/upload-post-skillManually: put the files in place
.devin/skills/upload-post/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Upload-Post/upload-post-skill --skill upload-post -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about upload-post
How do I install upload-post in Claude?
Run npx skills add Upload-Post/upload-post-skill --skill upload-post -a claude-code. The skill lands in ~/.claude/skills/upload-post/SKILL.md.
What does upload-post do?
It gives the agent an API reference for Upload-Post, so it can publish video, photos, text and documents to social platforms, schedule posts and read analytics.
What do I need before using it?
An Upload-Post account with connected social profiles, a created profile and an API key. The profile name goes into the user parameter of every request.
