Steven's Knowledge Base

README

2 min read

IG-Carousel Swipe Library

A curated library of Instagram carousel posts used as visual/pattern reference for the /ig-carousel-ad skill.

Purpose

When Steven says “整個 IG carousel ad”, the /ig-carousel-ad skill reads INDEX.md here to pick relevant references (matched by style, pattern, or angle), then imitates the winning mechanics — hero headline structure, colour split, template reuse, CTA placement — for the client’s own angle.

Layout

IG-Carousel/
├── README.md           ← this file
├── INDEX.md            ← every ingested post, sortable, read by the skill
├── by-creator/         ← canonical storage (one folder per post)
│   └── {handle}/
│       └── post-{short-id}/
│           ├── meta.md          ← frontmatter + observations
│           ├── slide-NN.png     ← authoritative per-slide screenshots
│           └── fullsize-ref-NN.jpg  ← clean full-resolution slides (when available)
├── by-style/           ← symlinks grouped by visual style
│   ├── dark-typography/
│   ├── white-minimal/
│   ├── 3d-hero/
│   ├── face-video/
│   └── serif-editorial/
└── by-pattern/         ← symlinks grouped by hook pattern
    ├── framework/
    ├── listicle/
    └── transformation/

How to ingest a new swipe

When Steven says “save 呢個 swipe: {URL}”:

  1. Scrape the Instagram post’s carousel slides (full-size CDN images + per-slide backup screenshots via ?img_index=N).
  2. Create by-creator/{handle}/post-{short-id}/ and copy:
    • slide-NN.png — one per slide (authoritative)
    • fullsize-ref-NN.jpg — clean slides only (filter pollution by file-size clustering)
  3. Write meta.md with YAML frontmatter (url, creator, post_id, scrape_date, slide_count, tags, style, pattern, angle, optional cta, engagement) and 3-5 bullet observations about what works.
  4. Add symlinks: by-style/{style}/{handle}-{short-id} and by-pattern/{pattern}/{handle}-{short-id} (use ln -s ../../by-creator/... with relative paths).
  5. Append a row to INDEX.md (sort by ingest date desc).
  1. Match by angle/pattern/style from Steven’s brief → reads INDEX.md.
  2. Load meta.md of 1-3 matching references → grounds the skill in what actually works.
  3. Load slide-01.png or fullsize-ref-01.jpg of the hero slides for visual grounding.
  4. Clone the template mechanics (colour split, type pair, footer wordmark, CTA placement) into the client’s own content — never copy words.

Ingest-quality caveats

  • Pollution warning: IG scrapes via network interception frequently capture “suggested posts” images alongside the real carousel. File-size clustering is the cheapest filter (genuine template slides cluster at one size-band; pollution images are outliers). Slide counts are authoritative via the per-slide ?img_index=N screenshots.
  • Backup PNGs are modal-overlaid (IG login gate) but edges/headers/footers of each slide remain visible — use as fallback when full-size captures are ambiguous.
  • When in doubt, the meta.md should note the confidence level (e.g., “only hero slide fullsize captured”).

Graph View