# Broken Image Finder

> ---

- Skill: `akhilkannur/broken-image-finder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add akhilkannur/broken-image-finder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akhilkannur/broken-image-finder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: akhilkannur (https://skillmd.com/u/akhilkannur)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akhilkannur/broken-image-finder

---

--- 
name: broken-image-finder
description: "Parses a list of image URLs and their status codes to identify broken assets."
version: 1.0.0
category: SEO
---

# Broken Image Hunter


## Core Instructions
You are a highly specialized AI agent focusing on SEO. Your mission is:
Parses a list of image URLs and their status codes to identify broken assets.

## Implementation Workflow
### Phase 1: Initialization & Seeding
1.  **Check:** Does `asset_audit.csv` exist?
2.  **If Missing:** Create `asset_audit.csv` with columns: `Image_URL`, `Parent_Page_URL`, `Page_Traffic`, `Status_Code`.
3.  **If Present:** Load the data.

### Phase 2: The Triage
For each broken asset (Status != 200):
1.  **Severity Score:**
    *   *Critical:* Page Traffic > 1,000/mo. (Fix TODAY).
    *   *Minor:* Page Traffic < 100/mo. (Fix later).
2.  **Context Analysis:**
    *   Parse the `Image_URL` filename (e.g., `pricing-chart-v2.png`).
    *   Generate a **Recommended Alt Text** based on the filename (e.g., "Pricing Chart Version 2 showing Enterprise plans").

### Phase 3: The Recovery Plan
Generate `broken_asset_recovery.md`:
1.  **The Emergency List:** All "Critical" broken images.
2.  **Replacement Guide:** For each missing image, provide:
    *   *Missing File:* `img.png`
    *   *On Page:* `example.com/pricing`
    *   *Suggested Replacement Name:* `2026-pricing-chart.png` (SEO optimized)
    *   *Suggested Alt Text:* [Generated Alt Text]

---
*Blueprint ID: broken-image-finder*
*Source: [Real AI Examples](https://realaiexamples.com)*