pinterest-posts — Claude Code skill: Pin copy and Pinterest SEO
This skill writes Pin titles and descriptions, picks boards and drafts alt text. Useful if Pinterest is one of your traffic sources.
npx skills add kostja94/marketing-skills --skill pinterest-posts -a claude-code
npx skills add kostja94/marketing-skills --skill pinterest -a claude-codeWhat pinterest-posts does
The skill covers Pin creation and optimization. Pinterest search works differently from Google, so long-tail phrases like "easy fall dinner recipes" beat broad terms. On first use it opens with a sentence or two on what it covers, then gives the output; later calls go straight to the result.
Rules are split by area. Titles run up to 100 characters, with the first 40 visible in feeds and the primary keyword inside them. Descriptions sit at 220–232 characters with a main keyword plus 2–3 related ones and a clear call to action. Board names and descriptions count as ranking factors, and the board a Pin lands on first shapes how Pinterest reads the content. The 2025 algorithm notes add that a new URL, a new image and a new board together give the widest distribution, alt text lifts impressions and clicks, and steady posting to relevant boards helps.
Output is a title, a description, a board recommendation and an alt text suggestion. Before that, the skill reads contextus.md at the project root when it exists and loads only the modules this task needs; without it, it works from project material and asks for what is missing. Expect three questions up front: content type, the board for the first save, and the goal — traffic, sales or signups. For asset specs it points you to visual-content.
What it helps with
- write a Pin title with the keyword in the first 40 characters
- fit a description into 220–232 characters with a call to action
- choose the board for a Pin's first save
- draft alt text for a Pin image
- plan content around the 2025 Pinterest algorithm
Example prompts for the agent
- Write a title and description for a Pin about fall dinner recipes
- Optimize this board description and pick keywords for it
- Draft alt text for this Pin and suggest a board
How to install pinterest-posts
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill pinterest-posts -a claude-codenpx skills add kostja94/marketing-skills --skill pinterest -a claude-code2Manually: put the files in place
~/.claude/skills/pinterest/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pinterest/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill pinterest -a codex2Manually: put the files in place
.agents/skills/pinterest/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill pinterest -a cursor2Manually: put the files in place
.cursor/skills/pinterest/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills pinterest2Manually: put the files in place
.github/skills/pinterest/SKILL.md1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill pinterest -a gemini-cli2Platform CLI
gemini skills install https://github.com/kostja94/marketing-skills --path skills/platforms/pinterestManually: put the files in place
.devin/skills/pinterest/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill pinterest -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pinterest-posts
How do I install pinterest-posts in Claude?
Run npx skills add kostja94/marketing-skills --skill pinterest-posts -a claude-code. The skill file then lives at ~/.claude/skills/pinterest/SKILL.md.
What does pinterest-posts do?
It helps create and optimize Pins: title, description, board and alt text. It also explains how Pinterest search behaves and what the algorithm rewards.
What should I have ready before using it?
The skill reads contextus.md at the project root when present. Without it, it falls back on your project material and asks questions about content type, board and goal.
Source text
SKILL.md · MIT
--- name: pinterest-posts description: When the user wants to create Pinterest Pins, optimize Pin descriptions, or grow Pinterest presence. Also use when the user mentions "Pinterest," "Pin," "Pinterest SEO," "Pinterest description," "Pinterest board," or "Pinterest marketing." For asset specs, use visual-content. metadata: version: 1.0.1 --- # Platforms: Pinterest Guides Pinterest Pin creation and optimization. Pinterest users search differently than Google; long-tail keywords like "easy fall dinner recipes" perform better than broad terms. Use this skill when creating Pins, optimizing boards, or planning Pinterest content. **When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Initial Assessment **Project context:** Read root `contextus.md` when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system. Identify: 1. **Content type**: Product, recipe, tutorial, inspiration 2. **Board**: Where Pin will be saved first (shapes Pinterest's understanding) 3. **Goal**: Traffic, sales, email signups ## Pin Title | Rule | Guideline | |------|-----------| | **Length** | Up to 100 chars; first 40 visible in feeds | | **Keyword** | Primary keyword in first 40 chars | | **Business name** | In first sentence → 54% higher email signup conversion | ## Pin Description | Rule | Guideline | |------|-----------| | **Length** | 220–232 chars optimal | | **Keywords** | Main + 2–3 related; natural placement | | **CTA** | Clear, actionable → 70% signup boost, 6% sales lift | | **Price** | When relevant → 28% sales increase | ## Board SEO - **Board name** and description are ranking factors - **First save** board shapes Pinterest's content understanding - Use keywords in board title and description ## 2025 Algorithm Notes - **Fresh content**: New URL + new image + new board = max distribution - **Alt text**: Pins with alt text earn ~25% more impressions, 123% more clicks - **Consistency**: Keyword-optimized content to relevant boards ## Output Format - **Title** (under 100 chars) - **Description** (220–232 chars) - **Board** recommendation - **Alt text** suggestion ## Related Skills - **content-marketing**: Pinterest as channel - **display-ads**: Pinterest Ads (if paid) - **visual-content**: Cross-channel visual planning; Pinterest Pin specs in context - **url-slug-generator**: URL for landing page
© kostja94 · MIT · kostja94/marketing-skills
