postiz — Claude Code skill: what it does, how to install
A skill to schedule posts across 28+ social networks and chat platforms using Postiz CLI directly inside your coding agent.
npx skills add gitroomhq/postiz-agent --skill postiz -a claude-codeWhat postiz does
This skill connects your agent to the Postiz command line interface. It allows the agent to inspect connected accounts, upload media assets, and schedule posts across 28+ channels including Telegram and Reddit.
You must install the global postiz CLI beforehand with npm install -g postiz or pnpm install -g postiz. Every command requires valid authentication. Run postiz auth:login for browser OAuth2 or export your POSTIZ_API_KEY. Without active credentials, commands immediately exit with an error.
Local file paths cannot be passed directly to -m. Every image or clip must go through postiz upload first to retrieve a verified .path. Posting to TikTok requires setting content_posting_method to DIRECT_POST. Choosing UPLOAD sends media to the inbox instead of publishing it.
What it helps with
- schedule posts across 28+ social media channels and chats
- upload media files using
postiz uploadbefore publishing - retrieve connected integrations and their configuration schemas
- inspect post analytics and resolve missing provider links
Example prompts for the agent
- Check authentication status with
postiz auth:status - List all connected accounts using
postiz integrations:list - Upload banner.png via
postiz uploadand schedule a post for tomorrow
How to install postiz
1Skills CLI (Vercel)
npx skills add gitroomhq/postiz-agent --skill postiz -a claude-code2Manually: put the files in place
~/.claude/skills/postiz/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/postiz/
1Skills CLI (Vercel)
npx skills add gitroomhq/postiz-agent --skill postiz -a codex2Manually: put the files in place
.agents/skills/postiz/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gitroomhq/postiz-agent --skill postiz -a cursor2Manually: put the files in place
.cursor/skills/postiz/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gitroomhq/postiz-agent postiz2Manually: put the files in place
.github/skills/postiz/SKILL.md1Skills CLI (Vercel)
npx skills add gitroomhq/postiz-agent --skill postiz -a gemini-cli2Platform CLI
gemini skills install https://github.com/gitroomhq/postiz-agent --path skills/postizManually: put the files in place
.devin/skills/postiz/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gitroomhq/postiz-agent --skill postiz -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 postiz
How do I install postiz in Claude Code?
Run npx skills add gitroomhq/postiz-agent --skill postiz -a claude-code. You also need the CLI installed via npm install -g postiz or pnpm install -g postiz.
What does postiz do?
It lets your coding agent run Postiz CLI commands to schedule and manage posts across 28+ channels. The agent can upload media, fetch channel rules, and publish updates on schedule.
Why must media files be uploaded before attaching them to a post?
Publishing targets reject raw local file paths and external URLs. Running postiz upload <file> uploads the asset to Postiz and returns a verified .path that target networks accept.
