Can I customize the image output folder?

Yes, the script allows you to specify a custom directory as an optional argument; otherwise, it defaults to a folder named after your file.

Does it work with private Twitter accounts?

The skill downloads publicly accessible image URLs (pbs.twimg.com) that are already present in your Markdown text.

How does it handle download failures?

It uses curl with a 30-second connection timeout and provides a detailed success/failure report at the end of the process.

Is it compatible with Windows?

The skill is designed for Unix-like environments (macOS/Linux). Windows users can run it via WSL (Windows Subsystem for Linux).

Twitter Image Downloader

Name: Twitter Image Downloader
Author: ttmouse

byttmouse

•

Content Management

Extracts and downloads Twitter/X image assets from Markdown files while automatically updating local file paths.

This Claude Code Skill automates the tedious process of migrating hosted Twitter (pbs.twimg.com) images to local storage. It scans Markdown documents for Twitter image URLs, downloads them using optimized curl commands with browser-like headers, organizes them into dedicated directories, and generates a ready-to-publish version of the file with updated local paths. By handling batch downloads and path replacement, it reduces a manual 10-minute task into a reliable 20-second automated workflow.

Key Features

01Cross-platform compatibility for macOS and Linux environments

02Batch downloading with simulated User-Agent headers to prevent blocking

03Instant Markdown path replacement for seamless local publishing

04Automated directory creation and sequential file renaming for organization

05Automatic extraction of pbs.twimg.com image links from Markdown source

0635 GitHub stars

Use Cases

01Converting online research notes into self-contained local Markdown documents

02Backing up external Twitter image assets for long-term article preservation

03Preparing blog posts for static site generators that require local image assets

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ttmouse/skills twitter-image-downloader

For use in Claude.ai and ChatGPT

Download Skill