docs-medialisted

# docs-media — Media Analysis ## Workflow 1. **Gather the docs** — get the list of pages in scope and read their content. If a semantic/graph search tool over the markdown is available (self-hosted `markdown-lsp`, or a connected Docsbook workspace), prefer it — faster and cheaper than scanning files; otherwise read the files directly with `grep`/`find`. Prioritize Tier 1 pages (quick-start, pricing, auth, install) first. 2. **Check scope** — if no image or video references are found in the page content, skip this skill. 3. **Apply checklist** — from the page content / graph: detect missing alt text, generic filenames, missing captions. For physical file checks (size, age, dimensions), note that local repo access is required. 4. **Produce report** — return one JSON issue object per finding, sorted by severity. Note which checks required local access and were skipped. ## Guardrails - Do not edit any documentation files — surface findings only. - Physical file checks (size in KB, file age, image dimensions) require local repo access — note when these are skipped. - Skip this skill entirely if no media references are found in the doc content. - Empty alt (`![]()`) is correct for decorative images — flag only when surrounding context implies the image is informative. - Converting PNG diagrams to Mermaid is a recommendation, not a requirement — ask the user before flagging as an issue. ## Inputs This skill needs two things, by whatever means are available: - **The list of pag