fix-blog-images

Fix Blog Images

Fixes image issues in uncommitted blog posts before publishing.

Workflow

1. Run the analysis script:

python3 scripts/fix_blog_images.py --json

2. 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

3. 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 or 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.