chapter-media

Plans, places, optimizes, and uploads chapter images to Cloudinary with link rewriting.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/nimdvir/dima-publishing --skill chapter-media-nimdvir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chapter-media
Source: https://github.com/nimdvir/dima-publishing/tree/main/.agents/skills/chapter-media
Command: npx skills add https://github.com/nimdvir/dima-publishing --skill chapter-media-nimdvir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing all the images for a textbook chapter—suggesting figures, placing local files, optimizing them, uploading to Cloudinary, and rewriting Markdown links—normally requires juggling several separate tools and manual steps that are easy to get wrong. ## Core Features & Use Cases - Plan-first pipeline: Runs a read-only Phase 0 inventory with unused-image candidate discovery from a media-master CSV, then waits for approval before editing anything. - End-to-end media stages: Suggests figure placements, resolves them into local images with captions and sequential numbering, optimizes with ImageMagick, uploads to Cloudinary, and rewrites links with proper transform chains. - Interactive menu and smart start: Presents a numbered menu (dry run, suggest, place, optimize, full pipeline, scan for new images, section scope) and auto-detects which stage to begin from. - Use Case: You are updating chapter 5 of the BITM330 textbook. Run the full pipeline to inventory existing figures, place unused images from the chapter folder, upload them to Cloudinary, and update the media ledger in one controlled workflow. ## Quick Start Run the chapter-media skill on ch05 and choose the full pipeline option from the interactive menu to suggest, place, and optimize all chapter images.

Frequently Asked Questions about chapter-media

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add and optimize images for a textbook chapter?▼

Invoke the skill with a chapter identifier like ch05 and pick a mode from the interactive menu. The full pipeline runs suggest, place, and optimize stages in sequence, always starting with a read-only Phase 0 plan that requires your approval before any edits.

How do I find unused images in a chapter folder?▼

Choose menu option 7 to scan the chapter's .images folder for files not yet referenced in the chapter. The skill first greps media-master.csv for instant status lookups, then cross-references the chapter file and presents unplaced images for your decision.

Does the skill upload images to Cloudinary automatically?▼

Uploads happen only in the optimize stage after you approve the plan. Images are optimized with ImageMagick into a chNN-used folder, uploaded via Cloudinary MCP servers with overwrite disabled, and links are rewritten with f_auto, q_auto, c_limit transform chains.

Can I run the pipeline on just one section of a chapter?▼

Yes, menu option 8 enables section scope. All stages are constrained to the named heading, figure numbering continues sequentially within the chapter, and the media ledger update remains chapter-wide.

What are the limitations of the chapter media workflow?▼

It does not edit prose, change page breaks, import source files, run final readiness checks, or publish content. Those tasks route to separate skills like chapter-editor, chapter-source-import, chapter-final-check, and book-deploy.