Social Media Content Skill

This skill provides guidelines for creating engaging social media content that drives engagement and shares.

When to Use This Skill

Use this skill when asked to:

• Write a LinkedIn post

• Create a Twitter/X thread

• Draft social media announcements

• Repurpose blog content for social

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" )

Example:

task( subagent_type="researcher", description="Research renewable energy trends in 2025. Save findings to research/renewable-energy.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

Example: A LinkedIn post about "prompt engineering" → linkedin/prompt-engineering/

You MUST complete both steps:

• Write the content to the appropriate path

• Generate an image using generate_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/🧵 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.

For thought-provoking content:

Two overlapping translucent circles, one blue one orange, creating a glowing intersection in the center. Represents collaboration or intersection of ideas. Dark charcoal background, soft ethereal glow. Minimalist and contemplative.

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:

• Post saved to linkedin/<slug>/post.md or tweets/<slug>/thread.md

• Image generated alongside the post

• First line hooks attention

• Content fits platform limits

• Tone matches platform norms

• Has clear CTA or question

• Hashtags are relevant (not generic)