# Migrate Images

> Scrape, download, and localize external or relative images referenced in markdown files to Astro's src/assets folder and rewrite image links.

- Skill: `rodydavis/migrate-images` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rodydavis/migrate-images`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rodydavis/migrate-images/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: rodydavis (https://skillmd.com/u/rodydavis)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rodydavis/migrate-images

---

# Migrate Images Skill

This skill scans all Markdown files in the `src/content/docs` folder and downloads external, relative, or site-hosted images locally to the `src/assets` folder. It then automatically computes and rewrites the correct relative image links inside the markdown files.

## When to Use

Use this skill whenever:
- You copy or import posts from a remote site (e.g. `rodydavis.com`) that reference hosted images.
- You want to bundle all images locally within the Astro codebase to support optimized builds and offline operation.
- Image assets need to be cleanly categorized under Astro's `src/assets/` folder.

## How it Works

The under-the-hood script:
1. Recursively walks all `.md` files in `src/content/docs`.
2. Uses Regex to extract image reference matches `![](...)`.
3. Skips external HTTP/HTTPS absolute links unless they match the source website base domain (`https://rodydavis.com`).
4. Downloads remote/relative images using `fetch` and pipelines them to `src/assets` using sanitized safe filenames.
5. Calculates the relative path from the Markdown file to the localized image in `src/assets` and replaces the old reference in-place.

## Execution

Run this command from the project root:

```bash
node .agents/skills/migrate-images/scripts/migrate-images.js
```