From Planable SMM
Generate a clear, client-ready social media performance summary from Planable analytics or a user-uploaded CSV export. Use this skill whenever the user asks for a monthly report, performance recap, analytics summary, results overview, or says things like "summarize last month's performance", "give me a report for [client]", "how did we do this month", "pull the analytics for [workspace]", or uploads a CSV with social media data and asks for a summary. Works with or without a Planable account — activate for any analytics summary request, whether the source is the Planable connector or a file upload.
How this skill is triggered — by the user, by Claude, or both
Slash command
/planable-smm:monthly-performance-summaryThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate a plain-language performance summary from Planable analytics data or a CSV export.
Generate a plain-language performance summary from Planable analytics data or a CSV export. Works in two modes: connected (pulls data live via Planable) or CSV (user uploads their own export).
Mode A — Planable connector (default) The user has a Planable account connected and wants to pull live data.
Mode B — CSV upload The user has uploaded (or will upload) a CSV export from Planable or any social media analytics tool.
How to detect:
list_workspaces → find workspaceId
list_pages(workspaceId) → get all pageIds
get_page_metrics(workspaceId, pageIds, startDate, endDate)
get_page_metrics_summary(workspaceId, pageIds, startDate, endDate)
get_post_metrics_summary(workspaceId, pageIds, startDate, endDate)
For top post highlights, also call:
get_post_metrics(workspaceId, pageIds, startDate, endDate, limit: 5)
Note on unsupported platforms: get_page_metrics returns unsupportedPages for Google My Business and Threads — note these in the report as "data not available."
If no file is uploaded yet, ask: "Please upload your CSV export and I'll summarize it."
Supported sources: Planable Analytics export, Hootsuite, Sprout Social, Meta Business Suite, LinkedIn Analytics, or any tabular CSV with date, platform, and metric columns.
Read the uploaded file. Identify:
date, period, week, month, or similarplatform, channel, network, page, profileIf the structure is unclear or columns are ambiguous, ask one clarifying question before proceeding.
Flexible parsing rules:
Deliver the report as a downloadable HTML file — a self-contained visual report the user can open in a browser, share with a client, or screenshot. Also output a short plain-text summary in chat so the user can see the key numbers without opening the file.
Generate a single .html file saved to /mnt/user-data/outputs/[client-name]-[month]-report.html. Use present_files after creating it.
The report must be visually designed — not a raw data dump. Follow these design principles:
Aesthetic direction: Clean, modern agency report. Light background, bold accent color (use Planable green #3BBA7B as primary accent). Card-based layout. Generous whitespace. Clear hierarchy.
Required sections and visual treatment:
4 metric cards in a row (or 2×2 on narrow):
Each card: big bold number, label, and trend arrow + % change vs. prior period (if available). Use color: green for up ↑, red for down ↓, gray for flat.
One card per platform. Each card shows:
Up to 5 posts in a ranked list. Each entry:
Two columns side by side:
Keep bullets short and specific. No generic advice.
Small, muted section at the bottom. Flag data gaps, unsupported platforms, report freshness.
"Generated with Planable + Claude · [date]"
.html file — no external dependencies except Google Fonts (loaded via <link>)DM Sans or Plus Jakarta Sans for body, Sora or Bricolage Grotesque for headings:root@media print block that hides nothing essentialColor palette:
:root {
--green: #3BBA7B;
--green-light: #EAF7F0;
--amber: #F59E0B;
--red: #EF4444;
--text: #1A1A2E;
--text-muted: #6B7280;
--bg: #F8FAFC;
--card: #FFFFFF;
--border: #E5E7EB;
}
After presenting the file, also output a short in-chat summary using emojis for scannability:
📅 [Client] — [Month Year]
📊 Key numbers
👥 Audience: [X] [↑/↓ X% vs last month]
👀 Impressions: [X]
💬 Engagement: [X] ([X]% rate)
📅 Posts: [X]
📱 By platform
[emoji] [Platform]: [X] impressions · [X]% eng rate · [X] posts
...
🏆 Top post: "[preview]" — [X] engagements
✅ What worked: [one line]
⚠️ Watch: [one line]
Keep the in-chat summary to ~15 lines max. The HTML file is the full deliverable.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub planable/smm-skills --plugin planable-smm