SuperAPI AI Directory

content-factory

Marketing & growth

View repository

Updated 10-16 05:29

About this skill

Content Factory — HuggingFace Trends → Instagram Carousel

Pull today's trending HuggingFace models, pick the one that matters most for the user's niche, and produce a 7-slide Instagram carousel ready to render in Higgsfield.

This skill is built to run daily, but every run is self-contained — it does not read prior days' data.

When to use

User prompts that should trigger this skill:

  • "Pull today's trending HuggingFace models and make a carousel."
  • "Run the trending DB."
  • "Today's AI trends to an Instagram post."
  • "Daily HuggingFace pull."

Inputs

Ask once at the start (skip whichever the user already provided):

  1. Niche: what audience the carousel is for. Default: "AI for marketing operators."
  2. Brand voice: 2–3 tone words. Default: "direct, practical, no-hype."
  3. Brand handle / signature: what to put on slide 7's CTA. Default: skip the CTA branding.

Workflow — strict order

Step 1 — Pull the trending list

Run the Playwright scraper:

node skills/content-factory/scripts/fetch-huggingface-trending.mjs --top 10 --out output/content-factory/<YYYY-MM-DD>/raw-trends.json

This visits https://huggingface.co/models?sort=trending, scrapes the top N, and writes both:

  • output/content-factory/<YYYY-MM-DD>/raw-trends.json (today's pull)
  • An append-only row in skills/content-factory/data/trending.db (SQLite — write-only from this skill's perspective)

If the scrape fails (network, layout change, anti-bot), fall back to examples/sample-trending-pull.json and tell the user the run is using a fixture.

Step 2 — Niche-map

Load prompts/niche-mapping.md and rank today's pulled models by relevance to the user's niche. Output a short ranked list (model name, relevance 1–10, one-line "why it matters for this audience"). Drop anything below 6.

Step 3 — Pick one trend

Pick the highest-relevance, most-explainable trend. If two are tied on relevance, prefer the one that's easier to demo visually.

Step 4 — Build the carousel

Load prompts/trend-to-carousel.md and produce 7 slides. Each slide gets:

  • Slide copy (≤14 words on the visible card).
  • Speaker-note expansion (1–3 sentences for the caption pull).
  • A Higgsfield image prompt using templates/carousel-slide-prompt.md.

Slide structure:

# Purpose
1 Hook — tension or stat that makes them swipe
2 What it is
3 Why it matters NOW
4 How to use it (1 concrete workflow)
5 What changes for the audience's job
6 The bigger pattern (zoom out)
7 CTA — save / follow / comment trigger

Step 5 — Write the caption

Use templates/caption-template.md. Caption ≤2200 chars (IG limit), front-loaded, last paragraph is the CTA.

Step 6 — Higgsfield handoff

For each slide's image prompt:

  1. If the Higgsfield MCP is connected, call ToolSearch with query higgsfield and use the image-generation tool to render the slide.
  2. If not, output the prompt paste-ready under the slide.

Never invent Higgsfield tool names — discover them at runtime.

Step 7 — Write outputs

Final deliverable structure:

output/content-factory/<YYYY-MM-DD>/
├── raw-trends.json
├── ranked.md             # Step 2 output
├── carousel.md           # Slides + caption + Higgsfield prompts
└── higgsfield-prompts.md # Just the prompts, paste-ready

Scheduling — pick one

This skill runs once per day. Three ways to wire it up:

Option A — /loop inside a Claude Code session (good for: testing, manual oversight)

/loop 24h Run the content-factory skill on today's HuggingFace trending list for the niche "AI for marketing operators".

Option B — Claude Code /schedule (cloud routine) (good for: laptop-off, hands-off)

/schedule daily at 08:00 ET — Run the content-factory skill on today's HuggingFace trending list...

Option C — crontab on this machine (good for: simple, local, no cloud)

0 8 * * * cd ~/Coding/higgsfield && claude -p "Run the content-factory skill on today's HuggingFace trending list for the niche 'AI for marketing operators'." >> ~/Coding/higgsfield/output/content-factory/cron.log 2>&1

The skill itself does NOT install any of these — that's the user's call.

Voice & tone

  • Match the user's stated brand voice. If unspecified: direct, practical, no-hype.
  • Slide 1 hook must NOT use "this changes everything" / "you won't believe" / "game-changer." If it does, rewrite.
  • Slide 7 CTA is always concrete (save / share / comment a specific word) — never "follow for more."

Demo command

Pull today's trending HuggingFace models and turn the most relevant one into an Instagram carousel for the niche "AI for marketing operators".