Content
# Planable MCP Skills
Production-ready Claude Agent Skills for social media managers, paired with the [Planable MCP server](https://mcp.planable.io/mcp) and — for the cross-channel skills — the [SE Ranking MCP server](https://seranking.com/api/integrations/mcp/). Each skill is a packaged instruction set Claude loads automatically when relevant — turning Planable data (companies, pages, posts, approvals, comments, media, analytics) and SE Ranking data (keywords, competitors, audits, AI-search visibility, rank tracking) into finished SMM deliverables: post batches, approval roundups, performance reports, content calendar audits, cross-client overviews, content pattern analysis, and full SEO + AI + social workflows.
These skills follow [Anthropic's Agent Skills spec](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview): each `SKILL.md` has YAML frontmatter that tells Claude when to use it, and the body is loaded only when triggered (progressive disclosure).
## Skills
### Core Planable skills
| Skill | What it produces | Primary triggers |
|---|---|---|
| [draft-post-batch](skills/draft-post-batch/SKILL.md) | Platform-adapted draft posts created directly in Planable from a brief, with preview before commit, varied hooks, and validation flags | "draft posts", "write 5 LinkedIn posts", "create a post batch" |
| [pending-approvals-roundup](skills/pending-approvals-roundup/SKILL.md) | Single roundup of every post awaiting sign-off across all client workspaces, with 48h-deadline posts called out and publishing errors flagged separately | "what's pending approval", "approval queue", "what needs sign-off" |
| [monthly-performance-summary](skills/monthly-performance-summary/SKILL.md) | Client-ready HTML report from Planable analytics or any CSV export — KPI cards, per-platform breakdowns, top 5 posts, what worked / what to watch | "monthly report", "performance summary", "client report" |
| [content-calendar-audit](skills/content-calendar-audit/SKILL.md) | This-week schedule mapped by day with approval status, draft/missing-date callouts, gap detection, and an offer to draft fill-in content | "what's going out this week", "calendar audit", "weekly planning" |
| [cross-client-metrics-overview](skills/cross-client-metrics-overview/SKILL.md) | Comparative table across every client/workspace ranked by engagement rate, impressions, or volume — with top performer, most improved, and engagement-drop flags | "compare clients", "agency overview", "cross-workspace metrics" |
| [content-pattern-intelligence](skills/content-pattern-intelligence/SKILL.md) | 2–4 named recurring patterns per lens (engagement, impressions, engagement rate) with real post examples and specific hypotheses to test next | "what's working", "content patterns", "what should I test next" |
### Ecosystem skills (SE Ranking + Planable)
These bridge SE Ranking and Planable — turning search and AI-visibility insight into social content, coordinated rewrites, local visibility, client proposals, and cross-channel reporting. They require **both** MCPs connected.
| Skill | What it produces | Primary triggers |
|---|---|---|
| [seo-gaps-to-social-campaign](skills/seo-gaps-to-social-campaign/SKILL.md) | Themed social campaign drafted (and optionally scheduled) in Planable from SE Ranking keyword gaps, competitor wins, question keywords, and ranking losses — every post traceable to a search-demand source | "turn our SEO data into posts", "competitor is ranking for X, make posts about it", "build a social campaign from search demand" |
| [ai-search-gaps-to-social-campaign](skills/ai-search-gaps-to-social-campaign/SKILL.md) | AI-visibility snapshot + owned/contested/missing prompt clusters across ChatGPT, Perplexity, Gemini, AI Overview & AI Mode, plus social drafts targeting the missing narratives and a before/after tracking plan | "improve our AI visibility with social", "where are competitors winning in AI answers", "AEO/GEO content plan" |
| [site-audit-to-social-distribution](skills/site-audit-to-social-distribution/SKILL.md) | Prioritised SEO fix list, the rewritten page copy drafted in a Planable Universal content page for comments + approval, and a coordinated social distribution batch | "audit the site and help us fix weak pages", "coordinate a content refresh", "rewrite these pages and get them approved" |
| [local-gmb-visibility](skills/local-gmb-visibility/SKILL.md) | City-level SE Ranking project setup (per-city geo-targeted engines + keywords), a city-by-city ranking snapshot with competitor context, and Google Business Profile + local social drafts in Planable | "track our rankings in [city]", "set up local rank tracking", "create Google Business Profile posts" |
| [client-onboarding-proposal](skills/client-onboarding-proposal/SKILL.md) | Data-backed onboarding proposal pairing an SE Ranking SEO + AI audit with the client's current Planable social baseline — executive summary, current state, opportunities, scope, first 90 days, measurement plan | "build an onboarding proposal for [client]", "scope a SEO + AI + social engagement", "where do they stand and what's our plan" |
| [seo-ai-social-report](skills/seo-ai-social-report/SKILL.md) | One cross-channel performance report — short text conclusions in chat plus a self-contained interactive HTML report with KPI cards, hoverable trend charts, share-of-voice, and top posts | "combined SEO + AI + social report", "cross-channel dashboard for last month", "one report covering rankings, AI visibility and social" |
Two skills work without a Planable account by accepting a CSV export from any analytics tool: `monthly-performance-summary` and `content-pattern-intelligence`.
## Install
This repo doubles as a [Claude Code plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces). Installing the `planable-smm` plugin registers all six skills and auto-configures the Planable remote MCP server in one step.
### Claude Code (terminal)
```bash
/plugin marketplace add Planable/smm-skills
/plugin install planable-smm@planable
```
Skills appear under the `planable-smm` namespace — e.g. `/planable-smm:draft-post-batch`. Or just describe what you want (*"draft 5 LinkedIn posts for Acme"*, *"what's pending approval"*) and Claude picks the right skill automatically based on its frontmatter. Update later with `/plugin marketplace update planable`.
### Claude Desktop
If you use Cowork in Claude Desktop, install via the UI:
1. Open **Customize** in the sidebar.
2. Click **Personal plugin** → **+ Create plugin**.
3. Click **Add marketplace** and enter `Planable/smm-skills`.
4. Install `planable-smm` once the marketplace loads.
### Connect Planable
The Planable remote MCP (`https://mcp.planable.io/mcp`) auto-registers when you install the plugin — there's no separate `claude mcp add` step. On your first session, run `/mcp` and sign in via OAuth. No API token to manage.
If you don't have a Planable account yet, [sign up](https://planable.io) — a Team plan (or higher) is required for MCP access.
### Claude.ai projects (manual)
The plugin format is Claude Code / Desktop only. If you use Claude.ai projects instead, attach the individual `SKILL.md` files (or a zip of the `skills/` folder) to a Project — see [Anthropic's Agent Skills docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview). You'll also need to connect the [Planable MCP server](https://mcp.planable.io/mcp) separately via your Claude.ai integrations.
## How these skills chain
A typical agency week:
1. `pending-approvals-roundup` Monday morning — clear the queue.
2. `content-calendar-audit` — see what's going out this week.
3. `draft-post-batch` — fill any gaps.
4. End-of-month: `monthly-performance-summary` per client + `cross-client-metrics-overview` for the agency view.
5. Quarterly: `content-pattern-intelligence` — set hypotheses for the next batch.
A typical SEO-driven engagement (ecosystem skills):
1. `client-onboarding-proposal` at kickoff — set the baseline and scope.
2. `site-audit-to-social-distribution` — fix the weak pages and announce them.
3. `seo-gaps-to-social-campaign` and/or `ai-search-gaps-to-social-campaign` — turn search and AI-visibility gaps into ongoing social content.
4. `local-gmb-visibility` — for multi-location or local-first clients.
5. End-of-month: `seo-ai-social-report` — one cross-channel report instead of three.
## Requirements
- **Claude plan**: Pro, Max, or Teams (Skills are not available on free tier).
- **Planable plan**: MCP access on Team plan or higher. Analytics add-on required for the analytics columns in `cross-client-metrics-overview` and the Planable mode of `monthly-performance-summary` / `content-pattern-intelligence`.
- **SE Ranking plan** (ecosystem skills only): MCP access on a plan that includes the Data API. Projects are required for ranking-loss detection, ongoing AI Result Tracker, and city-level rank tracking; one-off audits and AI Search snapshots work without a project. See the [SE Ranking MCP setup guide](https://seranking.com/api/integrations/mcp/).
- **Permissions**: Skills inherit the connected user's Planable and SE Ranking permissions.
- **Drafts only**: `draft-post-batch` and the ecosystem campaign skills create drafts; nothing publishes to social platforms without explicit user action in Planable.
## Links
- Planable: https://planable.io
- Planable remote MCP: https://mcp.planable.io/mcp
- Planable MCP help: https://help.planable.io/hc/en-us/articles/27538577098780-How-to-connect-Planable-MCP-to-your-AI-tools
- Anthropic Agent Skills spec: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
## License
MIT. See `LICENSE`.
## Contributing
Bug reports and improvements welcome. Open an issue with the skill name, the input, and the unexpected output.
