Post to social media with Agent Skills
Agent Skills is a CLI + markdown approach to giving AI coding tools the ability to manage your OmniSocials workspace. Unlike MCP, Agent Skills work with any AI tool that can read a markdown file and run shell commands. That includes Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf, and Claude Code.
Install
Terminal
This installs the skill into your agent's skills directory: a SKILL.md instruction file plus the CLI (<skill-path>/scripts/omnisocials.js). Your AI agent reads the SKILL.md to learn how to use the CLI.
Set your API key
Terminal
The setup command prompts for your API key and stores it locally. Alternatively, export the env var directly:
Terminal
What your agent can do
Once installed, you can ask any compatible agent:
- "Show my connected social accounts"
- "Create a LinkedIn post announcing our new feature"
- "Schedule an Instagram reel for tomorrow at 9am"
- "How are my posts performing this week?"
- "Upload this image and create a Pinterest pin on the Spring Inspiration board"
The agent reads SKILL.md, generates the appropriate CLI command, and executes it. The CLI wraps the OmniSocials REST API with more than 40 commands covering posts, media, folders, hashtag sets, locations, audio search, accounts, analytics, the social inbox, and webhooks.
How it differs from the MCP server
| Agent Skills | MCP Server | |
|---|---|---|
| Works with | Any AI coding tool that can read markdown and run commands | MCP-compatible clients only |
| Install | npx skills add OmniSocials/omnisocials-agent-skills | npx -y @omnisocials/mcp-server |
| Protocol | CLI commands via bash | MCP structured tool calls |
| Best for | Broad compatibility across non-MCP tools | Deep native integration with MCP clients |
Both use the same API and the same API key. You can use both simultaneously in the same tool if you want.
Supported tools (via Agent Skills)
- Claude Code
- Cursor
- Windsurf
- GitHub Copilot
- OpenAI Codex
- Google Gemini CLI
- JetBrains AI Assistant
- Any other AI tool that can read a markdown file and execute shell commands
Source and documentation
Full documentation, examples, and the CLI source live on GitHub: OmniSocials/omnisocials-agent-skills
The repo includes a generated SKILL.md for every supported client and examples of common tasks.