| name | repurpose-pinterest |
| description | 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".
|
| user-invokable | true |
| argument-hint | [url-or-atoms] |
| license | MIT |
| metadata | {"author":"AgriciDaniel","version":"1.0.0","category":"content"} |
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 |