mcpField
S
social-media-image-sizes

social-media-image-sizes

github.com/branding5Creative & media71.8k installsUpdated 26w ago
Repository

About social-media-image-sizes

Social Media Image Sizes is a skill for checking and resizing images to fit specifications across nine social platforms. It ranks size matches and provides resize commands for available formats.

Key features

  1. 01Check images against platform specifications
  2. 02Rank matches from ideal to too small
  3. 03Filter by platform or match level
  4. 04Resize with cover or contain fitting
  5. 05List available image specifications

Use cases

  1. 01Find suitable social formats for a source image
  2. 02Prepare an image for a specific platform placement
  3. 03Resize images with a chosen crop or background
  4. 04Check all carousel slides for matching ratios

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/branding5/social-media-image-sizes --skill social-media-image-sizes

After installing, type/social-media-image-sizesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
LICENSE
README.md
package.json
.gitignore
references/
instagram.md
best-practices.md
facebook.md
linkedin.md
pinterest.md
threads.md
tiktok.md
snapchat.md
youtube.md
x-twitter.md
scripts/
check.js
platform-data.js
resize.js

Details

From the project README

Social Media Image Sizes

Check and resize images for 9 platforms / 60+ specs. Scripts mirror the logic at branding5.com/tools/social-media-cheat-sheet.

Setup

Run once after install:

cd <skill-dir>
npm install

Check an image

node scripts/check.js photo.jpg

Outputs a ranked match list — perfect → close → usable → too small — with an inline node scripts/resize.js command for every non-perfect match.

Filter by platform or match level:

node scripts/check.js photo.jpg --platform instagram
node scripts/check.js photo.jpg --filter perfect
node scripts/check.js photo.jpg --filter usable

Platform slugs: instagram facebook twitter linkedin tiktok youtube pinterest snapchat threads

Resize an image

node scripts/resize.js photo.jpg "Instagram Portrait Post"
# → photo-instagram-portrait-post.jpg  (1080×1350 px)

node scripts/resize.js photo.jpg "YouTube Custom Thumbnail"
# → photo-youtube-custom-thumbnail.jpg  (1280×720 px)

Default fit is cover (center-crop). Use --fit contain to letterbox instead:

node scripts/resize.js photo.jpg "LinkedIn Background Photo" --fit contain --bg f0f0f0
node scripts/resize.js photo.jpg "Instagram Portrait Post" --out ./exports/ig.jpg

List every available spec name:

node scripts/resize.js photo.jpg --list

Workflow

  1. Run check.js to see what a given image already matches
  2. Copy the suggested resize.js command from the output
  3. Run it — the output file is saved alongside the original by default

Gotchas

  • Sharp requires a native binary. On first npm install, it downloads a prebuilt binary for your platform. If install fails behind a proxy, set SHARP_IGNORE_GLOBAL_LIBVIPS=1 and retry.
  • All slides in an Instagram carousel must share the same aspect ratio. The first image sets the ratio for the whole carousel — check all slides, not just the first.
  • Facebook cover photo has two safe zones. Desktop shows 820×312; mobile crops to 640×360. Keep key content in the center 640×312.
  • YouTube banner safe area is much smaller than the file. The spec is 2560×1440 but only the center 1546×423 is guaranteed visible on all devices. check.js flags the full size; keep critical content in the safe area.
  • --fit cover center-crops. If the subject isn't centered, use --out to save, then manually crop, or use an image editor before running resize.

References

Full per-platform specs (load when you need detail for a specific platform):

  • references/instagram.md — profile, feed, stories, reels, carousel, ads
  • references/facebook.md — profile, cover, feed, stories, events, ads
  • references/x-twitter.md — profile, header, posts, ads
  • references/linkedin.md — profile, cover, feed, articles, ads
  • references/tiktok.md — profile, videos, ads
  • references/youtube.md — channel art, videos, thumbnails, shorts, ads
  • references/pinterest.md — profile, pins, idea pins, ads
  • references/snapchat.md — snaps, spotlight, stories, ads, filters
  • references/threads.md — profile, posts
  • references/best-practices.md — format, compression, safe zones, accessibility

Full compiled reference (all platforms in one file): AGENTS.md

Need to generate on-brand images at these sizes? Branding5 pairs your brand kit with AI to produce social content pre-sized for every platform.

Comments

Markdown supported