Social Content

Hashtag Research Framework

Hashtag Rules by Platform

• Twitter/X: 1-2 hashtags max. Integrate into text or add at end.
• LinkedIn: 3-5 hashtags at the end of the post.
• Instagram: 10-15 hashtags. Put in first comment or after 5 line breaks.
• TikTok: 3-5 hashtags in caption. Include 1-2 trending tags.

Hashtag Don'ts

• Do not use banned or shadowbanned hashtags.
• Do not use the same hashtag set on every post (looks like bot behavior).
• Do not use irrelevant trending hashtags for reach (damages credibility and reach).
• Do not put hashtags in the middle of sentences.

Output Format

For every social content request, deliver:

1. Platform-Specific Posts

Full post copy formatted for each requested platform with:

• Hook line
• Body content
• CTA
• Hashtags (where applicable)
• Image/video direction (if relevant)
• Character count

2. Engagement Strategy

• Best time to post
• Recommended follow-up actions (respond to comments, reshare, etc.)
• Cross-promotion plan across platforms

3. Visual Direction

• Image/graphic description for design team
• Carousel slide outlines (if applicable)
• Video script hook (if applicable)

4. Variations

• 2-3 post variations per platform for A/B testing or scheduling across days.

API Integrations (Optional Enhancements)

The following integrations enhance the social content workflow but are not required. The skill works fully without them.

Unsplash Image Sourcing

If UNSPLASH_CLIENT_ID is available, source high-quality, royalty-free images for social posts:

# Search Unsplash for social media images
curl -s "https://api.unsplash.com/search/photos?query={topic}&per_page=3" \
  -H "Authorization: Client-ID ${UNSPLASH_CLIENT_ID}"

Parsing the response for social media use:

# Extract image URLs and attribution info
curl -s "https://api.unsplash.com/search/photos?query={topic}&per_page=3" \
  -H "Authorization: Client-ID ${UNSPLASH_CLIENT_ID}" | \
  jq -r '.results[] | {
    image_regular: .urls.regular,
    image_small: .urls.small,
    image_thumb: .urls.thumb,
    photographer: .user.name,
    photographer_url: .user.links.html,
    download: .links.download,
    color: .color,
    width: .width,
    height: .height
  }'

Key fields for social media:

• .urls.regular - 1080px wide, good for LinkedIn and Twitter posts
• .urls.small - 400px wide, good for thumbnails and previews
• .color - Dominant color hex code (useful for matching brand colors or creating cohesive visual themes)
• .width / .height - Original dimensions (check aspect ratio fits the target platform)

Platform-specific image tips:

• For Instagram (1080x1080 or 1080x1350): Search with orientation=squarish
• For Twitter/LinkedIn (1200x675): Search with orientation=landscape
• For TikTok/Reels/Stories (1080x1920): Search with orientation=portrait

Attribution: Unsplash requires attribution. Include "Photo by [Name] on Unsplash" in the post caption, image overlay, or as a text comment. Example:

Photo by [Photographer Name](photographer_url) on [Unsplash](https://unsplash.com)

Reddit Trending Topics & Community Sentiment

If REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET are available, monitor Reddit for trending topics, popular discussions, and community sentiment to inform social content:

Step 1: Get an access token

# Get Reddit access token (OAuth2 client credentials flow)
curl -s -X POST "https://www.reddit.com/api/v1/access_token" \
  -u "${REDDIT_CLIENT_ID}:${REDDIT_CLIENT_SECRET}" \
  -d "grant_type=client_credentials" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}"

The response contains:

{
  "access_token": "your_token_here",
  "token_type": "bearer",
  "expires_in": 86400,
  "scope": "*"
}

Extract the token:

REDDIT_ACCESS_TOKEN=$(curl -s -X POST "https://www.reddit.com/api/v1/access_token" \
  -u "${REDDIT_CLIENT_ID}:${REDDIT_CLIENT_SECRET}" \
  -d "grant_type=client_credentials" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}" | jq -r '.access_token')

Step 2: Search for trending topics in a subreddit

# Get hot posts from a relevant subreddit
curl -s "https://oauth.reddit.com/r/{subreddit}/hot?limit=25" \
  -H "Authorization: Bearer ${REDDIT_ACCESS_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}"

Step 3: Parse trending posts for content ideas

# Extract post titles, scores, and comment counts for content inspiration
curl -s "https://oauth.reddit.com/r/{subreddit}/hot?limit=25" \
  -H "Authorization: Bearer ${REDDIT_ACCESS_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}" | \
  jq -r '.data.children[] | .data | {
    title: .title,
    score: .score,
    num_comments: .num_comments,
    url: .url,
    created_utc: .created_utc,
    selftext: (.selftext | if length > 200 then .[:200] + "..." else . end)
  }'

Step 4: Search across Reddit for a specific topic

# Search Reddit-wide for discussions about a topic
curl -s "https://oauth.reddit.com/search?q={topic}&sort=relevance&t=week&limit=25" \
  -H "Authorization: Bearer ${REDDIT_ACCESS_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}"

How to use Reddit data for social content:

• Trending topics: Posts with high scores (500+) and comment counts indicate what the community cares about right now. Use these as content topics.
• Language and framing: Note how Redditors phrase problems and questions. Mirror this language in your social hooks for authenticity.
• Sentiment: Scan comments for common pain points, frustrations, or excitement. Address these directly in your posts.
• Content gaps: If a Reddit thread has lots of questions but no clear answers, that is a content opportunity.
• Timing: If a topic is trending on Reddit today, create social content about it within 24-48 hours for maximum relevance.

Useful subreddits by niche:

• Marketing: r/marketing, r/digital_marketing, r/SEO, r/socialmedia
• Tech: r/technology, r/programming, r/webdev, r/SaaS
• Business: r/entrepreneur, r/smallbusiness, r/startups
• Design: r/design, r/graphic_design, r/UI_Design

Note: Reddit API rate limits are 100 requests per minute. The access token expires after 24 hours. Always include a descriptive User-Agent string as Reddit blocks requests with generic user agents.

Publishing Content via API

These integrations let you post directly to social platforms from the terminal. Always show the user what will be posted and ask for confirmation before publishing.

Posting to Reddit

Requires REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, and a Reddit user account OAuth token.

Step 1: Get a user-authenticated token

Reddit posting requires the authorization_code OAuth flow (not client_credentials). The user must authorize once:

# Generate the authorization URL (user visits in browser)
echo "https://www.reddit.com/api/v1/authorize?client_id=${REDDIT_CLIENT_ID}&response_type=code&state=openclaudia&redirect_uri=http://localhost:8080&duration=permanent&scope=submit,read,identity"

After the user authorizes and gets the code from the redirect:

# Exchange code for access + refresh token
curl -s -X POST "https://www.reddit.com/api/v1/access_token" \
  -u "${REDDIT_CLIENT_ID}:${REDDIT_CLIENT_SECRET}" \
  -d "grant_type=authorization_code&code={CODE}&redirect_uri=http://localhost:8080" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}"

Save the refresh_token for future sessions:

# Refresh an expired token
curl -s -X POST "https://www.reddit.com/api/v1/access_token" \
  -u "${REDDIT_CLIENT_ID}:${REDDIT_CLIENT_SECRET}" \
  -d "grant_type=refresh_token&refresh_token={REFRESH_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}"

Step 2: Post to a subreddit

# Text post (self post)
curl -s -X POST "https://oauth.reddit.com/api/submit" \
  -H "Authorization: Bearer ${REDDIT_ACCESS_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}" \
  -d "sr={subreddit}&kind=self&title={post_title}&text={post_body}&api_type=json"

# Link post
curl -s -X POST "https://oauth.reddit.com/api/submit" \
  -H "Authorization: Bearer ${REDDIT_ACCESS_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}" \
  -d "sr={subreddit}&kind=link&title={post_title}&url={url}&api_type=json"

Step 3: Post a comment (for engagement)

curl -s -X POST "https://oauth.reddit.com/api/comment" \
  -H "Authorization: Bearer ${REDDIT_ACCESS_TOKEN}" \
  -A "${REDDIT_USER_AGENT:-openclaudia-skills:v1.0}" \
  -d "thing_id={parent_fullname}&text={comment_body}&api_type=json"

The thing_id is the fullname of the post or comment to reply to (e.g., t3_abc123 for a post, t1_abc123 for a comment).

Reddit posting best practices:

• Check subreddit rules before posting (/r/{subreddit}/about/rules)
• Many subreddits have minimum karma/age requirements
• Avoid self-promotion in subreddits that prohibit it — focus on value
• Post during peak hours (9-11 AM EST for US subreddits)
• Use the subreddit's preferred flair if required
• Space out posts — no more than a few per day across all subreddits

Multi-Platform Posting via EngageMate

If ENGAGEMATE_API_KEY is set, you can use EngageMate to post across Reddit, X/Twitter, Instagram, Facebook, and TikTok from a single API.

echo "ENGAGEMATE_API_KEY is ${ENGAGEMATE_API_KEY:+set}"

EngageMate is an AI-powered social engagement platform. Refer to their documentation at https://engagemate.app for current API endpoints. The product ID is stored as ENGAGEMATE_PRODUCT_ID.

Publishing Workflow

When the user asks to post or publish content:

1. Generate the content using the platform-specific rules above
2. Preview — show the user exactly what will be posted, including:
   • Platform and target (subreddit, account, etc.)
   • Title (if applicable)
   • Full post body
   • Hashtags, links, media
3. Confirm — ask the user to approve before posting
4. Post — execute the API call
5. Report — show the post URL and any response data

Never auto-post without explicit user confirmation.