# 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

```bash
npx skills add OmniSocials/omnisocials-agent-skills
```

This drops a `SKILL.md` file and a CLI wrapper (`./scripts/omnisocials.js`) into your project. Your AI agent reads the SKILL.md to learn how to use the CLI.

## Set your API key

```bash
./scripts/omnisocials.js setup
```

The setup command prompts for your API key and stores it locally. Alternatively, export the env var directly:

```bash
export OMNISOCIALS_API_KEY=omsk_live_<YOUR_KEY>
```

## 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 30 commands covering posts, media, folders, locations, accounts, analytics, 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](https://github.com/OmniSocials/omnisocials-agent-skills)

The repo includes a generated SKILL.md for every supported client and examples of common tasks.