docs-medialisted

# docs-media — Media Analysis ## Workflow 1. **Connect to Docsbook** — run `list_workspaces` to find the workspace, then `get_doc_graph` and `read_doc_sections` to scan image references in markdown. Reindex if graph is empty or stale. 2. **Check scope** — if no image or video references are found in `read_doc_sections`, skip this skill. 3. **Apply checklist** — from Docsbook MCP: 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. ## MCP Tools | Tool | Purpose | |------|---------| | `mcp__docsbook__list_workspaces` | Find workspace | | `mcp__docsbook__get_doc_graph` | Page list with timestamps | | `mcp__docsbook__read_doc_sections` | Scan image references in markdown | | `mcp__docsbook__reindex_doc_graph` | Refresh