Claude-skill-registry fix-blog-images

Fix and optimize images in uncommitted blog posts. Use when preparing blog posts for publication, fixing broken image paths, renaming generic image names (image.png), moving images to proper /images/blog/ directory, improving alt text, or checking image references before committing. Trigger on "fix blog images", "check images", "prepare post for publish", or after pasting screenshots into markdown.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/fix-blog-images" ~/.claude/skills/majiayu000-claude-skill-registry-fix-blog-images && rm -rf "$T"

manifest: skills/data/fix-blog-images/SKILL.md

Fix Blog Images

Fixes image issues in uncommitted blog posts before publishing.

Workflow

Run the analysis script:

python3 scripts/fix_blog_images.py --json

Review output and for each issue:
- rename_and_move: Move image to
```
/images/blog/
```
  with descriptive name
- improve_alt_text: Update alt text to describe the image content
- missing_image: Locate or remove the reference
Apply fixes:
- Move/rename image files to
```
packages/blog/public/images/blog/
```
- Update markdown references to use absolute paths
```
/images/blog/...
```
- Add descriptive alt text

Image Conventions

Location: All images in
```
packages/blog/public/images/blog/
```

Naming:

YYYYMMDD-HHMM-descriptive-name.png

YYYYMMDD-descriptive-name.png

References: Use absolute paths
```
/images/blog/filename.png
```
Alt text: Describe what the image shows for accessibility

Example Fix

Before:

![alt text](image.png)

After:

![Screenshot showing terminal layout](/images/blog/20251229-post-slug-image.png)

Addtional Notes

Don't try and Optimize Images. a git hook will run image optimization on commit. This skill is just to fix paths, names, and alt text before committing.