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
Title (100 characters max)
- Keyword-first: lead with the search term users would type
- Use "How to", "Best", "Ideas for", "X Ways to" formats
- Specific and descriptive -- avoid vague or clever wordplay
- Include the primary topic keyword in the first 40 characters
Description (500 characters max)
- First sentence: restate the value proposition with the primary keyword
- Middle: 2-3 sentences expanding on what the user will learn or gain
- End with a CTA: "Click to read the full guide" or "Save this for later"
- Naturally weave in 3-5 related keywords (no keyword stuffing)
- Write as a mini SEO snippet -- imagine it appearing in Google search results
Image direction
- Dimensions: 1000x1500 (2:3 tall portrait)
- Text overlay: title or key phrase in bold, readable font (5-10 words)
- Visual style: clean, aspirational, high-contrast
- Color: bright or warm tones perform best on Pinterest
- Include /banana prompt if
--images flag is set
Suggested board
- Which board this pin belongs to (from Output 3 or existing boards)
- 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:
Board name
- Keyword-rich and descriptive (e.g., "Healthy Meal Prep Ideas" not "Food")
- 3-5 words, search-friendly
Board description (up to 500 characters)
- SEO-optimized: include related keywords naturally
- Describe what a user will find on this board
- Aspirational tone: frame as a collection of valuable resources
Why it fits
- Brief explanation of how this content aligns with the board's theme
- 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 |
1---2name: repurpose-pinterest3description: Generates Pinterest content from content atoms: standard pin concepts (3-5 pins) with keyword-rich descriptions, idea pin scripts (5-10 slides), and board suggestions. Optimizes for saves, clicks, and SEO — Pinterest is a visual search engine, not social media. Sub-skill of the Content Repurposing Engine. Use when user says "pinterest", "pinterest pin", "idea pin", "pinterest board", or "repurpose for pinterest".4license: MIT5---67# Pinterest Content Generator89Generate standard pins, idea pin script, and board suggestions from content atoms.1011## Inputs1213Received from the parent agent (`repurpose-visual`):1415| Input | Description |16|-------|-------------|17| `atoms` | Full list of content atoms with types and impact ratings |18| `main_argument` | One-sentence thesis of the source content |19| `target_audience` | Who benefits from this content |20| `primary_topic` | Category or niche |21| `voice_profile` | Detected or overridden brand voice |22| `images_flag` | If true AND /banana available, generate images directly |23| `brief_mode` | If true, produce 1 pin description only |2425## References2627Load before generating:28- `references/platform-specs.md` -- pin dimensions, algorithm weights, posting times29- `references/hook-formulas.md` -- keyword-first titles, curiosity gap descriptions30- `references/image-sourcing.md` -- 3-tier image pipeline, prompt templates, platform dimensions3132## Platform Rules3334| Spec | Value |35|------|-------|36| Pin title | 100 characters max |37| Pin description | 500 characters max (keyword-first, SEO-rich) |38| Standard pin image | 1000x1500 (2:3 tall format) |39| Square pin image | 1080x1080 (1:1) |40| Idea pin slides | 2-20 slides, 1080x1920 (9:16) |41| Algorithm | Freshness + keyword relevance + saves + clicks |42| SEO value | HIGH -- Google indexes pins in image search and web results |43| Hashtags | 2-5 relevant tags |44| Best time | Sat/Sun 8-11PM, weekdays 2-4PM |4546## Core Principle4748Pinterest 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.4950## Output 1: Standard Pins (3-5)5152Write to `pinterest/pins.md`.5354Generate 3-5 pin concepts. Each pin must include:5556### Pin Structure57581. **Title** (100 characters max)59 - Keyword-first: lead with the search term users would type60 - Use "How to", "Best", "Ideas for", "X Ways to" formats61 - Specific and descriptive -- avoid vague or clever wordplay62 - Include the primary topic keyword in the first 40 characters63642. **Description** (500 characters max)65 - First sentence: restate the value proposition with the primary keyword66 - Middle: 2-3 sentences expanding on what the user will learn or gain67 - End with a CTA: "Click to read the full guide" or "Save this for later"68 - Naturally weave in 3-5 related keywords (no keyword stuffing)69 - Write as a mini SEO snippet -- imagine it appearing in Google search results70713. **Image direction**72 - Dimensions: 1000x1500 (2:3 tall portrait)73 - Text overlay: title or key phrase in bold, readable font (5-10 words)74 - Visual style: clean, aspirational, high-contrast75 - Color: bright or warm tones perform best on Pinterest76 - Include /banana prompt if `--images` flag is set77784. **Suggested board**79 - Which board this pin belongs to (from Output 3 or existing boards)80 - Why this board is the right fit8182### Pin SEO Rules8384| Do | Don't |85|----|-------|86| Lead titles with primary keyword | Use clickbait or vague titles |87| Write descriptions like SEO snippets | Stuff keywords unnaturally |88| Include "how to", "best", "ideas" in titles | Use hashtags as the only discovery mechanism |89| Add 2-5 relevant hashtags at the end | Use more than 5 hashtags |90| Front-load the most important keyword | Bury the topic in the middle of the description |91| Write for searchers with intent | Write for casual scrollers |9293## Output 2: Idea Pin Script (5-10 Slides)9495Write to `pinterest/idea-pin.md`.9697### Slide-by-Slide Structure9899| Slide | Purpose | Content |100|-------|---------|---------|101| **Slide 1** | Hook/Cover | Bold title (5-8 words), eye-catching visual, "Keep swiping" cue |102| **Slides 2-3** | Problem/Context | Why this matters, relatable pain point or aspiration |103| **Slides 4-7** | Core value | One insight per slide from highest-impact atoms, actionable steps |104| **Slide 8-9** | Summary/Result | Key takeaway, before/after, or transformation promise |105| **Final slide** | CTA | Follow prompt, save prompt, link to full content |106107### Idea Pin Rules108- Dimensions: 1080x1920 (9:16 vertical) for all slides109- One idea per slide -- never stack multiple concepts110- Text overlay on every slide: large, bold, readable at mobile size111- Visual consistency: same color palette, font style, and layout across all slides112- Cover slide determines whether anyone swipes -- invest the most effort here113- Include a "step" or "number" indicator on instructional slides (Step 1, Step 2...)114- Background should be clean and not compete with text overlay115116### Visual Direction117118For each slide, specify:119- Headline text (5-10 words, bold)120- Supporting text (1-2 short lines, if any)121- Background treatment (solid color, lifestyle photo, flat lay, gradient)122- Text position (centered, top-third, bottom-third)123- Color palette (consistent across all slides)124125## Output 3: Board Suggestions126127Write to `pinterest/boards.md`.128129Suggest 2-3 relevant boards to pin content to.130131### Board Structure132133For each board:1341351. **Board name**136 - Keyword-rich and descriptive (e.g., "Healthy Meal Prep Ideas" not "Food")137 - 3-5 words, search-friendly1381392. **Board description** (up to 500 characters)140 - SEO-optimized: include related keywords naturally141 - Describe what a user will find on this board142 - Aspirational tone: frame as a collection of valuable resources1431443. **Why it fits**145 - Brief explanation of how this content aligns with the board's theme146 - Which pins from Output 1 belong here147148### Board Strategy149- Boards act as keyword categories -- name them for search, not creativity150- A well-named board helps ALL pins on it rank higher in Pinterest search151- Suggest one broad board and one niche board minimum152153## Image Prompts154155If `--images` flag is set, suggest:156- **Standard pins**: 2:3 (1000x1500) visual concepts for each pin157- **Idea pin cover**: 9:16 (1080x1920) cover slide concept158- Include /banana prompt descriptions (subject, context, style, composition, text overlay)159160## Output Format161162Each file should include the content plus production notes:163164```markdown165# Pinterest Pin: [Topic]166167## Pin 1168**Title:** [keyword-first title, 100 chars max]169**Description:** [SEO-rich description, 500 chars max]170**Image:** [visual direction]171**Board:** [suggested board name]172**Hashtags:** [2-5 tags]173174## Pin 2175...176177---178**Posting notes:** [best time, SEO tips, board strategy]179```180181## Brief Mode182183If `--brief` is active, produce only:184- 1 pin description + image direction (highest-impact atom, keyword-optimized)185- Skip idea pin and board suggestions186187## Error Handling188189| Condition | Action |190|-----------|--------|191| Fewer than 3 atoms | Generate fewer pins to match; minimum 1 pin |192| Content not visual | Focus on text-overlay pins with clean backgrounds |193| No clear keywords | Analyze main_argument and primary_topic for search terms |194| `--images` but no /banana | Save prompts to file; suggest Canva templates as alternative |195| Content is time-sensitive | Note in posting notes that Pinterest favors evergreen content |196| Atoms lack actionable angle | Reframe as "how to" or "ideas for" to match Pinterest search intent |