ingest-performance

Solid

Feed last month's real numbers into next month's plan: ingest a platform analytics export (CSV from Instagram Insights, LinkedIn analytics, TikTok Studio, X analytics — any export with a post-id column) into per-post performance records, then rank the month's wins with sample floors and margin rules so ideation compounds measured winners, not remembered ones. Triggers on "/ingest-performance", "here are last month's numbers", "import analytics", "which posts performed best", "engagement report", "what worked last month", or whenever ideate-month needs its wins rung fed. Writes performance.json next to the month's tracker; /socialforge:ideate-month reads it and labels every win measured vs anecdotal.

AI & Automation 38 stars 6 forks Updated 3 weeks ago MIT

Install

View on GitHub

Quality Score: 83/100

Stars 20%
53
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# /socialforge:ingest-performance — real numbers into the wins rung `/socialforge:ideate-month` compounds "what worked last month." Before this skill, that meant whatever someone remembered in the planning call — and memory favors the post that felt good, not the one that performed. This skill turns the platform's own export into the record ideation reads. ## Step 1 — Get the export Ask the user for the analytics export covering the month. Any CSV works if it has a column identifying the post (`post_id`, `post`, `id`) that matches the calendar's post ids, plus whichever metrics the platform provides (impressions/views, likes/reactions, comments, shares/reposts, saves, clicks, follows — header aliases are normalized automatically). If the export keys posts by URL or caption instead of the calendar id, help the user add a `post_id` column first — matching is by calendar id, deliberately: wins must map back to the topics and pillars that produced them. ## Step 2 — Ingest ```bash python ${CLAUDE_PLUGIN_ROOT}/scripts/ingest_performance.py --action ingest \ --brand {brand} --month {YYYY-MM} --csv {export.csv} --source "{platform} export" ``` - Rows matching calendar post ids are stored in `output/{brand}/{month}/performance.json` (repeat ingests append — one CSV per platform is normal). - **Unmatched rows are listed in the output, never silently dropped.** Show the user the unmatched list; a typo'd id is data lost from the wins rung. - Exit 3 = nothing matched. Stop...

Details

Author
indranilbanerjee
Repository
indranilbanerjee/socialforge
Created
5 months ago
Last Updated
3 weeks ago
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Listed

ingest-performance

Feed last month's real numbers into next month's plan: ingest a platform analytics export (CSV from Instagram Insights, LinkedIn analytics, TikTok Studio, X analytics — any export with a post-id column) into per-post performance records, then rank the month's wins with sample floors and margin rules so ideation compounds measured winners, not remembered ones. Triggers on "/ingest-performance", "here are last month's numbers", "import analytics", "which posts performed best", "engagement report", "what worked last month", or whenever ideate-month needs its wins rung fed. Writes performance.json next to the month's tracker; /socialforge:ideate-month reads it and labels every win measured vs anecdotal.

0 Updated 3 weeks ago
teachskillofskills-ai
Data & Documents Listed

ideate-month

Plan next month's content calendar from a theme, raw signals, and last month's results — before any calendar exists. Triggers on "/ideate-month", "/plan-month", "what should we post next month", "plan the calendar", "ideas for next month", "month theme", "content ideas for [brand]", "build a calendar from scratch", or any time a brand needs a month planned and no client calendar has arrived. Outputs a calendar-data.json-compatible draft — series arcs, one-off posts, tiers, platforms — that feeds straight into /socialforge:parse-calendar and the production pipeline. Reads the brand profile for pillars and voice; mines pasted news/trends/notes into on-pillar angles; compounds last month's measured wins (fed by /socialforge:ingest-performance, with anecdotal reports labeled as such) instead of starting from zero.

0 Updated 3 weeks ago
teachskillofskills-ai
Data & Documents Solid

ideate-month

Plan next month's content calendar from a theme, raw signals, and last month's results — before any calendar exists. Triggers on "/ideate-month", "/plan-month", "what should we post next month", "plan the calendar", "ideas for next month", "month theme", "content ideas for [brand]", "build a calendar from scratch", or any time a brand needs a month planned and no client calendar has arrived. Outputs a calendar-data.json-compatible draft — series arcs, one-off posts, tiers, platforms — that feeds straight into /socialforge:parse-calendar and the production pipeline. Reads the brand profile for pillars and voice; mines pasted news/trends/notes into on-pillar angles; compounds last month's measured wins (fed by /socialforge:ingest-performance, with anecdotal reports labeled as such) instead of starting from zero.

38 Updated 3 weeks ago
indranilbanerjee