Recommends placement of images, pull quotes, infographics, and sidebars within articles based on structure, pacing, and editorial logic.
How this skill is triggered — by the user, by Claude, or both
Slash command
/autopunk-media-skills:layout-placement-advisorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Recommends where to place visual elements — images, pull quotes, infographics, and sidebars — within a specific article, based on the article's structure, pacing, and editorial logic.
Recommends where to place visual elements — images, pull quotes, infographics, and sidebars — within a specific article, based on the article's structure, pacing, and editorial logic.
Required: A summary or full text of the article (or at minimum a paragraph-by-paragraph outline), plus a list of the visual assets available — describe each asset briefly (e.g., "portrait photo of the main subject," "bar chart showing five-year cost increases," "pull quote: 'We had three days to get out'").
Optional: The publication medium (print spread, single-column web, mobile-first web). Word count and approximate number of pages or scroll sections. Any house rules about visual placement (e.g., no image in the first paragraph, pull quotes must appear in the second half only).
A numbered placement plan, one entry per visual asset. Each entry states: the asset (described briefly), the recommended placement (before which paragraph or section, or at what approximate word count), and a one-sentence rationale. Ends with an optional "spacing check" noting whether the overall visual rhythm feels balanced and flagging any dead zones longer than approximately 600 words. Plain editorial language — no design jargon.
Article: "The Last Bus Route" — a 1,800-word reported feature about rural transport cuts in a mountainous region. Structure:
Visual assets available: A. Portrait photo of the elderly woman (main subject) B. Bar chart: rural route reductions by year, 2019–2024 C. Wide landscape photo: the empty rural road where the bus used to run D. Pull quote: "My doctor is forty kilometres away. I haven't been in eight months." (from testimony section) E. Pull quote: "The numbers didn't add up. They never did for these communities." (from a resident, testimony section)
Medium: single-column web article, mobile-first. No house rules specified.
Medium: Single-column web, mobile-first Word count: ~1,800 words Visual assets: 5
1. Asset A — Portrait photo of the elderly woman Place: At the top of the article, before paragraph 1 (as the hero/lead image). Rationale: The opening scene centres entirely on this woman — her photo establishes the human anchor of the piece before the reader processes a single word. On mobile, a strong portrait immediately above the headline drives scroll-through.
2. Asset C — Wide landscape photo: the empty road Place: After paragraph 2 (end of the background section, before the data section). Rationale: The background section describes a nationwide pattern; the landscape photo gives that abstraction a physical reality. It also provides a visual break after ~500 words of text, which is the first risk point for scroll abandonment on mobile.
3. Asset B — Bar chart: rural route reductions 2019–2024 Place: Within paragraph 3 (the data section), immediately after the sentence that references the 34% reduction figure. Rationale: Data visuals work best when placed at the exact moment the text references them — readers scan the chart then return to the sentence, reinforcing rather than interrupting comprehension. Do not place this chart before the statistic is mentioned in the text.
4. Asset D — Pull quote: "My doctor is forty kilometres away..." Place: Mid-way through paragraph 4 (the testimony section), after the first resident's account and before the second. Rationale: This is the strongest single line in the testimony section — concrete, emotional, and immediately understandable. Placing it mid-testimony breaks the section visually at its most impactful moment and rewards readers who are skimming by giving them the emotional core of the piece at a glance.
5. Asset E — Pull quote: "The numbers didn't add up..." Place: Hold — do not use. Rationale: With Asset D already in the testimony section, placing a second pull quote in the same section creates visual clutter and dilutes the impact of both. Asset E is also less vivid than Asset D. If a visual is needed in paragraph 5 (the counter-argument section), consider a short sidebar fact box instead. Otherwise, leave that section as clean text — at ~200 words, it does not require a break.
Overall rhythm: Balanced. No section exceeds 400 words without a visual or a natural structural break. The closing text-only run is editorially justified.
npx claudepluginhub ur-grue/autopunk-media-skills --plugin autopunk-media-skillsSplits long-form articles into web-optimized sections with subheadings, pull-quote suggestions, image placement markers, and reading-time estimates for CMS-ready content.
Audits newsletter drafts for visual opportunities and generates on-brand visual assets. Use for enhancing drafts with [screenshot] placeholders or 'add visuals' requests.
Analyzes article structure, identifies positions requiring visual aids, and generates consistent illustrations using a Type × Style × Palette approach. Invoked when users request article illustration, image generation, or 为文章配图.