# upload-post

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 503 installs · ★ 38
- Author: Upload-Post
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Upload-Post/upload-post-skill/tree/HEAD/SKILL.md
- Updated: 2026-07-20
- HTML: https://affpapa.org/en/nevibecode/skills/upload-post

## What it 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.

## Requirements
- Works with: LinkedIn

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Upload-Post/upload-post-skill --skill upload-post -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/upload-post/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/upload-post/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Upload-Post/upload-post-skill --skill upload-post -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/upload-post/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Upload-Post/upload-post-skill --skill upload-post -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/upload-post/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Upload-Post/upload-post-skill upload-post
```

2. **Manually: put the files in place**
- File: `.github/skills/upload-post/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Upload-Post/upload-post-skill --skill upload-post -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Upload-Post/upload-post-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/upload-post/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Upload-Post/upload-post-skill --skill upload-post -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Upload-Post/upload-post-skill/tree/HEAD/SKILL.md

## When to use it
- 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
- 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

## Similar
- [typefully](https://affpapa.org/en/nevibecode/skills/typefully.md) — skill · 2000 installs
- [post-writer-sms](https://affpapa.org/en/nevibecode/skills/post-writer-sms.md) — skill · 1900 installs
- [linkedin-post-writer](https://affpapa.org/en/nevibecode/skills/linkedin-post-writer.md) — skill · 628 installs
- [text-post-and-microblog](https://affpapa.org/en/nevibecode/skills/text-post-and-microblog.md) — skill · 604 installs
- [linkedin-post-formatter](https://affpapa.org/en/nevibecode/skills/linkedin-post-formatter.md) — skill · 359 installs
- [transcript-intelligence](https://affpapa.org/en/nevibecode/skills/transcript-intelligence.md) — skill · 1300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md