repurpose-pinterest

Pinterest Content Generator

Generate standard pins, idea pin script, and board suggestions from content atoms.

Inputs

Received from the parent agent (repurpose-visual):

| Input | Description | |-------|-------------| | atoms | Full list of content atoms with types and impact ratings | | main_argument | One-sentence thesis of the source content | | target_audience | Who benefits from this content | | primary_topic | Category or niche | | voice_profile | Detected or overridden brand voice | | images_flag | If true AND /banana available, generate images directly | | brief_mode | If true, produce 1 pin description only |

References

Load before generating:

• references/platform-specs.md -- pin dimensions, algorithm weights, posting times
• references/hook-formulas.md -- keyword-first titles, curiosity gap descriptions
• references/image-sourcing.md -- 3-tier image pipeline, prompt templates, platform dimensions

Platform Rules

| Spec | Value | |------|-------| | Pin title | 100 characters max | | Pin description | 500 characters max (keyword-first, SEO-rich) | | Standard pin image | 1000x1500 (2:3 tall format) | | Square pin image | 1080x1080 (1:1) | | Idea pin slides | 2-20 slides, 1080x1920 (9:16) | | Algorithm | Freshness + keyword relevance + saves + clicks | | SEO value | HIGH -- Google indexes pins in image search and web results | | Hashtags | 2-5 relevant tags | | Best time | Sat/Sun 8-11PM, weekdays 2-4PM |

Core Principle

Pinterest is a visual SEARCH ENGINE, not social media. Keyword placement matters more than engagement bait. Every pin description should read like a mini SEO snippet. Users are planners and dreamers -- they search with intent to save, try, and buy.

Output 1: Standard Pins (3-5)

Write to pinterest/pins.md.

Generate 3-5 pin concepts. Each pin must include:

Pin Structure

1. Title (100 characters max)
2. Keyword-first: lead with the search term users would type
3. Use "How to", "Best", "Ideas for", "X Ways to" formats
4. Specific and descriptive -- avoid vague or clever wordplay
5. Include the primary topic keyword in the first 40 characters

1. Description (500 characters max)
2. First sentence: restate the value proposition with the primary keyword
3. Middle: 2-3 sentences expanding on what the user will learn or gain
4. End with a CTA: "Click to read the full guide" or "Save this for later"
5. Naturally weave in 3-5 related keywords (no keyword stuffing)
6. Write as a mini SEO snippet -- imagine it appearing in Google search results

1. Image direction
2. Dimensions: 1000x1500 (2:3 tall portrait)
3. Text overlay: title or key phrase in bold, readable font (5-10 words)
4. Visual style: clean, aspirational, high-contrast
5. Color: bright or warm tones perform best on Pinterest
6. Include /banana prompt if --images flag is set

1. Suggested board
2. Which board this pin belongs to (from Output 3 or existing boards)
3. Why this board is the right fit

Pin SEO Rules

| Do | Don't | |----|-------| | Lead titles with primary keyword | Use clickbait or vague titles | | Write descriptions like SEO snippets | Stuff keywords unnaturally | | Include "how to", "best", "ideas" in titles | Use hashtags as the only discovery mechanism | | Add 2-5 relevant hashtags at the end | Use more than 5 hashtags | | Front-load the most important keyword | Bury the topic in the middle of the description | | Write for searchers with intent | Write for casual scrollers |

Output 2: Idea Pin Script (5-10 Slides)

Write to pinterest/idea-pin.md.

Slide-by-Slide Structure

| Slide | Purpose | Content | |-------|---------|---------| | Slide 1 | Hook/Cover | Bold title (5-8 words), eye-catching visual, "Keep swiping" cue | | Slides 2-3 | Problem/Context | Why this matters, relatable pain point or aspiration | | Slides 4-7 | Core value | One insight per slide from highest-impact atoms, actionable steps | | Slide 8-9 | Summary/Result | Key takeaway, before/after, or transformation promise | | Final slide | CTA | Follow prompt, save prompt, link to full content |

Idea Pin Rules

• Dimensions: 1080x1920 (9:16 vertical) for all slides
• One idea per slide -- never stack multiple concepts
• Text overlay on every slide: large, bold, readable at mobile size
• Visual consistency: same color palette, font style, and layout across all slides
• Cover slide determines whether anyone swipes -- invest the most effort here
• Include a "step" or "number" indicator on instructional slides (Step 1, Step 2...)
• Background should be clean and not compete with text overlay

Visual Direction

For each slide, specify:

• Headline text (5-10 words, bold)
• Supporting text (1-2 short lines, if any)
• Background treatment (solid color, lifestyle photo, flat lay, gradient)
• Text position (centered, top-third, bottom-third)
• Color palette (consistent across all slides)

Output 3: Board Suggestions

Write to pinterest/boards.md.

Suggest 2-3 relevant boards to pin content to.

Board Structure

For each board:

1. Board name
2. Keyword-rich and descriptive (e.g., "Healthy Meal Prep Ideas" not "Food")
3. 3-5 words, search-friendly

1. Board description (up to 500 characters)
2. SEO-optimized: include related keywords naturally
3. Describe what a user will find on this board
4. Aspirational tone: frame as a collection of valuable resources

1. Why it fits
2. Brief explanation of how this content aligns with the board's theme
3. Which pins from Output 1 belong here

Board Strategy

• Boards act as keyword categories -- name them for search, not creativity
• A well-named board helps ALL pins on it rank higher in Pinterest search
• Suggest one broad board and one niche board minimum

Image Prompts

If --images flag is set, suggest:

• Standard pins: 2:3 (1000x1500) visual concepts for each pin
• Idea pin cover: 9:16 (1080x1920) cover slide concept
• Include /banana prompt descriptions (subject, context, style, composition, text overlay)

Output Format

Each file should include the content plus production notes:

# Pinterest Pin: [Topic]

## Pin 1
**Title:** [keyword-first title, 100 chars max]
**Description:** [SEO-rich description, 500 chars max]
**Image:** [visual direction]
**Board:** [suggested board name]
**Hashtags:** [2-5 tags]

## Pin 2
...

---
**Posting notes:** [best time, SEO tips, board strategy]

Brief Mode

If --brief is active, produce only:

• 1 pin description + image direction (highest-impact atom, keyword-optimized)
• Skip idea pin and board suggestions

Error Handling

| Condition | Action | |-----------|--------| | Fewer than 3 atoms | Generate fewer pins to match; minimum 1 pin | | Content not visual | Focus on text-overlay pins with clean backgrounds | | No clear keywords | Analyze main_argument and primary_topic for search terms | | --images but no /banana | Save prompts to file; suggest Canva templates as alternative | | Content is time-sensitive | Note in posting notes that Pinterest favors evergreen content | | Atoms lack actionable angle | Reframe as "how to" or "ideas for" to match Pinterest search intent |