| name | social-media |
| description | Drafts engaging social media posts, writes hooks, suggests hashtags, creates thread structures, and generates companion images. Use when the user asks to write a LinkedIn post, tweet, Twitter/X thread, social media caption, social post, or repurpose content for social platforms. |
Social Media Content Skill
Research First (Required)
Before writing any social media content, you MUST delegate research:
- Use the
task tool with subagent_type: "researcher"
- In the description, specify BOTH the topic AND where to save:
task(
subagent_type="researcher",
description="Research [TOPIC]. Save findings to research/[slug].md"
)
- After research completes, read the findings file before writing
Output Structure (Required)
Every social media post MUST have both content AND an image:
LinkedIn posts:
linkedin/
└── <slug>/
├── post.md # The post content
└── image.png # REQUIRED: Generated visual
Twitter/X threads:
tweets/
└── <slug>/
├── thread.md # The thread content
└── image.png # REQUIRED: Generated visual
You MUST complete both steps:
- Write the content to the appropriate path
- Generate an image using
generate_social_image and save alongside the post
A social media post is NOT complete without its image.
Platform Guidelines
LinkedIn
Format:
- 1,300 character limit (show more after ~210 chars)
- First line is crucial - make it hook
- Use line breaks for readability
- 3-5 hashtags at the end
Tone:
- Professional but personal
- Share insights and learnings
- Ask questions to drive engagement
- Use "I" and share experiences
Structure:
[Hook - 1 compelling line]
[Empty line]
[Context - why this matters]
[Empty line]
[Main insight - 2-3 short paragraphs]
[Empty line]
[Call to action or question]
#hashtag1 #hashtag2 #hashtag3
Twitter/X
Format:
- 280 character limit per tweet
- Threads for longer content (use 1/thread format)
- No more than 2 hashtags per tweet
Thread Structure:
1/ [Hook - the main insight]
2/ [Supporting point 1]
3/ [Supporting point 2]
4/ [Example or evidence]
5/ [Conclusion + CTA]
Image Generation
Every social media post needs an eye-catching image. Use the generate_social_image tool:
generate_social_image(prompt="A detailed description...", platform="linkedin", slug="your-post-slug")
The tool saves the image to <platform>/<slug>/image.png.
Social Image Best Practices
Social images need to work at small sizes in crowded feeds:
- Bold, simple compositions - one clear focal point
- High contrast - stands out when scrolling
- No text in image - too small to read, platforms add their own
- Square or 4:5 ratio - works across platforms
Writing Effective Prompts
Include these elements:
- Single focal point: One clear subject, not a busy scene
- Bold style: Vibrant colors, strong shapes, high contrast
- Simple background: Solid color, gradient, or subtle texture
- Mood/energy: Match the post tone (inspiring, urgent, thoughtful)
Example Prompts
For an insight/tip post:
Single glowing lightbulb floating against a deep purple gradient background, lightbulb made of interconnected golden geometric lines, rays of soft light emanating outward. Minimal, striking, high contrast. Square composition.
For announcements/news:
Abstract rocket ship made of colorful geometric shapes launching upward with a trail of particles. Bright coral and teal color scheme against clean white background. Energetic, celebratory mood. Bold flat illustration style.
Content Types
Announcement Posts
- Lead with the news
- Explain the impact
- Include link or next step
Insight Posts
- Share one specific learning
- Explain the context briefly
- Make it actionable
Question Posts
- Ask a genuine question
- Provide your take first
- Keep it focused on one topic
Quality Checklist
Before finishing:
