publish to social

Q: How do I install publish to social?

Run npx skills add https://github.com/gitroomhq/agent-media --skill publish-to-social in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/publish-to-social/ (personal) or .claude/skills/publish-to-social/ (project).

by gitroomhqBackend & APIs

Publish a generated Agent-Media video to the user's connected TikTok, Instagram, or X. Connect channels (OAuth) and post or schedule via the REST API. Use after producing a video with generatevideo.

Installs: 123
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/gitroomhq/agent-media --skill publish-to-social

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads publish to social automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Publish to Social

Post a finished agent-media video (an R2 video_url from any of the video skills) to the user's connected social channels: TikTok, Instagram, or X. Works from three surfaces: REST, the CLI (agent-media social ...), and MCP tools (social_channels / social_connect / social_publish). All calls use the user's Authorization: Bearer ma_... token against https://api.agent-media.ai.

1. Connect a channel (one-time, requires the human)

GET    /v1/social/providers             -> connectable networks: tiktok, instagram, instagram-standalone, x
POST   /v1/social/connect { provider }  -> { url }   # the user opens this OAuth url and authorizes
GET    /v1/social/channels              -> { channels: [{ id, name, provider, profile, picture }] }
DELETE /v1/social/channels/:channelId   -> disconnect

The connect step returns an OAuth URL the human must open and authorize; an agent cannot complete OAuth itself. Once authorized, the channel appears in /v1/social/channels with an id you pass to publish.

CLI: agent-media social providers · agent-media social connect x · agent-media social channels. MCP: social_connect { provider } (returns the URL for the user) · social_channels.

2. Publish a video

curl -X POST https://api.agent-media.ai/v1/social/publish \
  -H "Authorization: Bearer ma_..." -H "Content-Type: application/json" \
  -d '{ "video_url": "https://pub-...r2.dev/generation-outputs/<user>/<job>/...mp4",
        "channel_ids": ["<channel-id-from-/channels>"],
        "caption": "made with agent-media",
        "type": "now" }'    # or "type":"schedule" + "date":"2026-06-01T10:00:00.000Z"

CLI: agent-media social publish --video <url> --channels <id,id> --caption "..." (add --at <iso> to schedule). MCP: social_publish { video_url, channel_ids, caption, type }.

video_url must be an agent-media R2 URL (the output of a video skill); agent-media re-hosts it on the publishing provider for you. channel_ids come from /v1/social/channels. Per-network requirements (e.g. X reply settings) are filled in server-side; you don't send them.

Returns { success: true, media_id, post_ids: ["..."] }. A real post was created only when post_ids is non-empty; treat an empty post_ids as a failure, not a success.

Typical flow

Produce a video with generate_video and take final_output.video_url.
If the user has no connected channel, send them to connect (step 1); you can't OAuth for them.
Publish that video_url to the chosen channel_ids; confirm post_ids came back.

Note: social operations run on a shared rate budget: don't poll; connect once and publish on demand.

FAQ

What does the publish to social skill do?

Publish a generated Agent-Media video to the user's connected TikTok, Instagram, or X. Connect channels (OAuth) and post or schedule via the REST API. Use after producing a video with generatevideo.

How do I install publish to social?

Run npx skills add https://github.com/gitroomhq/agent-media --skill publish-to-social in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/publish-to-social/ (personal) or .claude/skills/publish-to-social/ (project).

Which AI agents can use publish to social?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is publish to social safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains publish to social?

It is published by gitroomhq in gitroomhq/agent-media. It has 123 recorded installs.

More from gitroomhq/agent-media

View all →

agent-media ugc playbook

gitroomhq/agent-media

Playbook for Agent-Media UGC Video — the one tool for UGC video on agent-media. Always call the single makeugc skill: give it a script (any length) and optionally a person/image/character; it returns the finished captioned vertical video. Short script → one clip, long monologue → full multi-take (never trimmed), brollurl → narrated overlay. You never pick a sub-skill.

Media & Creative122 installs