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 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:

After:

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.