Skill: hughtan93-dev/socialkit (version 0.1.0)

# SKILL.md - social-media-manager ## Metadata ```yaml name: social-media-manager-xiaoxing description: AI-powered social media management assistant for content creation, scheduling, and analytics version: 1.0.0 author: Xiao Xing tags: [social-media, content, marketing, automation, twitter, instagram, linkedin, facebook] ``` ## Overview Social Media Manager is a comprehensive AI-powered assistant that helps users manage their social media presence effectively. It can generate engaging content, research hashtags, plan posting schedules, analyze engagement metrics, and optimize for each platform's unique requirements. ## Capabilities ### 1. Content Generation - Generate social media posts for various platforms - Adapt tone and style to match brand voice - Create platform-specific content (Twitter threads, LinkedIn posts, Instagram captions) - Write compelling headlines and hooks - Repurpose content across platforms ### 2. Hashtag Research - Suggest relevant trending hashtags - Create branded hashtag strategies - Optimize hashtag density per platform - Generate hashtag bundles by niche/topic ### 3. Content Calendar - Plan content themes by week/month - Suggest optimal posting times per platform - Coordinate multi-platform campaigns - Track content pillars and themes ### 4. Engagement Analysis - Analyze post performance metrics - Suggest improvements based on engagement data - Identify best-performing content types - Benchmark against competitors ### 5. Platform-Specific Optimization - **Twitter/X**: Thread creation, character limits (280), GIF support, quote tweets - **Instagram**: Caption formatting, story ideas, Reel descriptions, carousel posts - **LinkedIn**: Professional tone, article suggestions, document uploads - **Facebook**: Community engagement, event promotion, group posting --- ## Content Generation Prompts by Platform ### Twitter/X Prompts **Thread Opener:** ``` Create a Twitter thread about [TOPIC]. Include: - A compelling hook (first tweet must grab attention in first 50 chars) - 5-7 substantive tweets expanding on the topic - A strong CTA in the final tweet - 2-3 relevant hashtags distributed naturally Tone: [professional/casual/humorous/inspirational] Brand voice: [describe your brand voice] ``` **Single Tweet:** ``` Write a single impactful tweet about [TOPIC]: - Max 280 characters - Include a hook in first 30 characters - Add value or emotion - End with 1-2 relevant hashtags or a CTA Tone: [specify] ``` **Example Thread:** ``` Topic: 5 AI Tools That Will Save You 10 Hours This Week Thread structure: 1/5 🚨 Stop wasting time on repetitive tasks. Here are 5 AI tools that changed my workflow: 2/5 1. @NotionAI - Writing and summarization 3/5 2. @Copy.ai - Marketing copy 4/5 3. @Midjourney - Visual content creation 5/5 Which one are you trying first? Drop your pick in the comments 👇 #AITools #Productivity #TechTips ``` ### Instagram Prompts **Post Caption:** ``` Create an Instagram caption for [CONTENT/VISUAL]: - Hook: 1-2 lines that stop the scroll - Body: 2-3 paragraphs telling a story or sharing value - CTA: Clear call-to-action (save, comment, share) - Hashtags: 5-15 relevant tags (mix of popular and niche) Brand aesthetic: [describe] Tone: [specify] ``` **Carousel Post:** ``` Design a carousel post about [TOPIC]: - Slide 1: Hook/Title - Slides 2-8: Content points (one per slide) - Slide 9: CTA/Summary - Each slide: Visual description + caption text Format: Educational/Entertainment/Behind-the-scenes ``` **Story Ideas:** ``` Generate 5 Instagram Story ideas for [BRAND/TOPIC]: - Mix of: poll, quiz, slider, question sticker, countdown - Each story: hook + interactive element + CTA ``` **Reel Description:** ``` Create a Reel description for [VIDEO CONTENT]: - First 3 lines: Hook (show up in feed) - Lines 4-10: Context/value proposition - CTA: Save, share, or comment - Hashtags: 3-5 relevant tags ``` ### LinkedIn Prompts **Professional Post:** ``` Write a LinkedIn post about [TOPIC]: - Opening: Personal story or bold statement - Body: 2-4 paragraphs with insights - Ending: Thought-provoking question or CTA - Length: 700-1500 characters ideal Tone: Professional, authentic, thought-leadership Industry: [specify] ``` **Article Outline:** ``` Create a LinkedIn article outline about [TOPIC]: - Title: Compelling, keyword-rich - Introduction: Hook + what reader will learn - 5-7 main points with subheadings - Conclusion: Key takeaways + CTA Target length: 1500-3000 words ``` **Company Update:** ``` Write a company update post: - Announce: [product/feature/milestone] - Why it matters: Benefit to audience - Quote: CEO or team member - CTA: Link to learn more Format: Professional, celebratory ``` ### Facebook Prompts **Post:** ``` Create a Facebook post for [TOPIC]: - Length: 80-200 words for reach - Hook: First 40 characters - Content: Conversational, community-focused - CTA: Comment, share, or visit link Tone: Friendly, community-oriented ``` **Event Promotion:** ``` Write a Facebook event post: - Event: [name, date, time, location] - Hook: What's the value of attending? - Details: Key information - CTA: RSVP link Format: Event announcement ``` --- ## Hashtag Generation Methods ### Method 1: Niche-Based Generation ``` Generate 20 hashtags for [NICHE/INDUSTRY]: - Top 5: Broad reach hashtags (1M+ posts) - Top 10: Medium reach (100K-1M posts) - Top 5: Niche hashtags (<100K posts) - Include: 1-2 branded hashtags ``` ### Method 2: Trending + Evergreen Mix ``` Create hashtag bundle for [TOPIC]: - 3 trending hashtags (currently viral) - 5 evergreen hashtags (consistent engagement) - 2 niche-specific hashtags - 1 branded hashtag ``` ### Method 3: Competitor Analysis ``` Research hashtags used by [COMPETITOR/INFLUENCER]: - Extract their top 20 hashtags - Identify patterns and themes - Suggest 10 alternative hashtags in same niche ``` ### Hashtag Best Practices by Platform | Platform | Optimal Count | Best Placement | Tips | |----------|---------------|----------------|------| | Twitter | 1-3 | End of tweet | Mix broad + niche | | Instagram | 5-15 | Caption end + first comment | 30 max limit | | LinkedIn | 3-5 | End of post | Industry-specific | | Facebook | 1-3 | End of post | Avoid over-tagging | --- ## Content Calendar Templates ### Weekly Content Plan | Day | Theme | Platform Focus | Content Type | |-----|-------|----------------|--------------| | Monday | Motivation | LinkedIn, Twitter | Quote, goals | | Tuesday | Educational | LinkedIn, Instagram | Tips, how-to | | Wednesday | Product/Service | All platforms | Feature highlight | | Thursday | Community | Facebook, Instagram | User stories, UGC | | Friday | Engagement | Twitter, Instagram | Poll, question, fun | | Saturday | Behind-the-Scenes | Instagram, Facebook | BTS, team, culture | | Sunday | Curated/Planning | All | Repurpose, plan | ### Monthly Content Themes **Example: Tech/SaaS Month** ``` Week 1: Product Features & Updates Week 2: Educational Content & Tips Week 3: Customer Success Stories Week 4: Industry Trends & Thought Leadership ``` **Example: E-commerce Month** ``` Week 1: New Product Launches Week 2: How-to Use/Style Guides Week 3: Customer Reviews/Testimonials Week 4: Special Offers/Behind-the-Scenes ``` ### Optimal Posting Times (General) | Platform | Best Times (EST) | Worst Times | |----------|------------------|-------------| | Twitter | 9am, 12pm, 5pm | 11pm-5am | | Instagram | 11am, 2pm, 7pm | 11pm-5am | | LinkedIn | 8am, 10am, 12pm | 6pm-6am | | Facebook | 9am, 1pm, 4pm | 12am-6am | --- ## Engagement Analysis Framework ### Key Metrics by Platform **Twitter/X:** - Impressions - Engagement rate (engagements/impressions) - Retweets, Likes, Replies - Follows from tweet - Link clicks **Instagram:** - Reach - Engagement rate - Saves - Shares - Profile visits **LinkedIn:** - Impressions - Engagement rate - Click-through rate - Comments - Reposts **Facebook:** - Reach - Engagement rate - Shares - Comments - Page likes ### Engagement Analysis Prompt ``` Analyze [POST] performance: - Metrics: [list actual numbers] - Compare to: Industry average / Previous posts - Strengths: What worked well - Weaknesses: What underperformed - Recommendations: 3-5 specific improvements ``` ### Content Performance Checklist - [ ] Hook captures attention in first 2 seconds - [ ] Value proposition is clear - [ ] Visual is high-quality and relevant - [ ] CTA is specific and actionable - [ ] Hashtags are relevant (not spammy) - [ ] Timing aligns with audience activity - [ ] Format matches platform norms --- ## Configuration Configure your preferences in a `config.json` file: ```json { "platforms": ["twitter", "instagram", "linkedin", "facebook"], "brand": { "name": "Your Brand", "voice": "professional|casual|humorous|inspirational", "colors": ["#hex1", "#hex2"], "hashtags": ["#brand1", "#brand2"] }, "posting": { "frequency": "daily|3x/week|weekly", "times": { "twitter": ["09:00", "12:00", "17:00"], "instagram": ["11:00", "14:00", "19:00"], "linkedin": ["08:00", "10:00", "12:00"], "facebook": ["09:00", "13:00", "16:00"] } }, "audience": { "demographics": "age, location, interests", "goals": "brand awareness, lead generation, community" } } ``` ## Scripts Available - **scripts/post_generator.py** - Generate platform-specific posts - **scripts/hashtag_tool.py** - Generate and research hashtags - **scripts/calendar_planner.py** - Plan content schedules ## References - **references/platform_guidelines.md** - Platform-specific posting rules - **references/best_practices.md** - Content strategy tips - **references/api_reference.md** - API documentation ## Notes - Always comply with platform terms of service - Maintain consistent brand identity - Engage with comments and messages promptly - Track competitors and industry trends - Test different posting times for your specific audience - Repurpose content across platforms with appropriate formatting

path: assets/example_asset.txt
content: # Example Asset File

This placeholder represents where asset files would be stored.
Replace with actual asset files (templates, images, fonts, etc.) or delete if not needed.

Asset files are NOT intended to be loaded into context, but rather used within
the output Claude produces.

Example asset files from other skills:
- Brand guidelines: logo.png, slides_template.pptx
- Frontend builder: hello-world/ directory with HTML/React boilerplate
- Typography: custom-font.ttf, font-family.woff2
- Data: sample_data.csv, test_dataset.json

## Common Asset Types

- Templates: .pptx, .docx, boilerplate directories
- Images: .png, .jpg, .svg, .gif
- Fonts: .ttf, .otf, .woff, .woff2
- Boilerplate code: Project directories, starter files
- Icons: .ico, .svg
- Data files: .csv, .json, .xml, .yaml

Note: This is a text placeholder. Actual assets can be any file type.


path: references/api_reference.md
content: # Reference Documentation for Social Media Manager

This is a placeholder for detailed reference documentation.
Replace with actual reference content or delete if not needed.

Example real reference docs from other skills:
- product-management/references/communication.md - Comprehensive guide for status updates
- product-management/references/context_building.md - Deep-dive on gathering context
- bigquery/references/ - API references and query examples

## When Reference Docs Are Useful

Reference docs are ideal for:
- Comprehensive API documentation
- Detailed workflow guides
- Complex multi-step processes
- Information too lengthy for main SKILL.md
- Content that's only needed for specific use cases

## Structure Suggestions

### API Reference Example
- Overview
- Authentication
- Endpoints with examples
- Error codes
- Rate limits

### Workflow Guide Example
- Prerequisites
- Step-by-step instructions
- Common patterns
- Troubleshooting
- Best practices


path: references/best_practices.md
content: # Social Media Best Practices - Content Strategy Tips

## Content Strategy Fundamentals

### The 80/20 Rule
- **80% Value**: Educational, entertaining, inspiring content
- **20% Promotion**: Product/service promotion
- Balance builds trust before selling

### Content Pillars
Establish 3-5 content pillars:
1. **Educational**: Tips, how-tos, tutorials
2. **Inspirational**: Motivation, success stories
3. **Entertainment**: Memes, fun facts, behind-the-scenes
4. **Promotional**: Products, services, offers
5. **Community**: UGC, questions, polls

---

## Content Creation Tips

### Writing Hooks That Work
```
Before: "Here are 5 tips for better productivity"
After: "I tried 5 productivity hacks for 30 days - here's what happened"

Before: "Our new feature is launching"
After: "We spent 6 months building this feature. Here's why it almost didn't happen."

Before: "Tips for better marketing"
After: "99% of businesses make this marketing mistake"
```

### Creating Scroll-Stopping Headlines
- Use numbers ("7 ways...", "5 reasons...")
- Create curiosity gaps
- Make bold claims
- Use power words: Secret, Ultimate, Proven, Essential
- Address pain points directly

### Call-to-Actions That Convert
- **Save-worthy**: "Save this for later!"
- **Comment-driven**: "What's your take? Drop it below"
- **Share-friendly**: "Tag someone who needs to see this"
- **Question-based**: "Which one resonates with you?"

---

## Platform-Specific Tips

### Twitter/X
- Tweet when your audience is active (analyze your metrics)
- Engage in conversations, don't just broadcast
- Use threads for complex topics
- Retweet with comment adds value
- Reply to others to build relationships

### Instagram
- Stories = daily presence (post 3-5 daily)
- Reels = reach (create weekly)
- Carousels = saves (educational content)
- Live = engagement (weekly)
- DMs = relationships (respond to all)

### LinkedIn
- Personal brand > Company page
- Document posts perform well
- First 3 lines matter most
- Comments drive more reach than posts
- Connect with purpose (not just numbers)

### Facebook
- Groups > Page (for community)
- Video > Images > Links
- Questions drive comments
- Respond to ALL comments
- Post when fans are online

---

## Engagement Best Practices

### Responding to Comments
- Respond within 1-2 hours
- Be personal, not generic
- Ask follow-up questions
- Add value to the conversation
- Show personality

### Building Community
- Ask questions regularly
- Feature user content
- Celebrate community members
- Host giveaways/contests
- Create专属 hashtags

### Handling Negative Feedback
- Don't delete (unless abusive)
- Respond professionally
- Take it offline when needed
- Learn from criticism
- Thank them for feedback

---

## Hashtag Strategy

### Finding Right Hashtags
1. Check competitors' hashtags
2. Use platform's suggested tags
3. Research niche-specific tags
4. Mix broad + medium + niche
5. Track performance over time

### Hashtag Formulas
```
Post engagement: [broad hashtag] + [niche hashtag] + [1 branded]

Educational: [topic] + [education] + [tips] + [learning]

Business: [industry] + [business] + [motivation] + [brand]

Location: [broad] + [location] + [niche]
```

### Platform-Specific Limits
- Twitter: 1-3 hashtags
- Instagram: 5-15 hashtags (30 max)
- LinkedIn: 3-5 hashtags
- Facebook: 1-3 hashtags

---

## Content Calendar Best Practices

### Planning Frequency
- **Monthly**: Theme + campaigns
- **Weekly**: Content pillars + themes
- **Daily**: Actual posting

### Weekly Content Mix (Example)
| Day | Content Type | Platform Focus |
|-----|--------------|----------------|
| Monday | Motivation/Goals | LinkedIn, Twitter |
| Tuesday | Educational | LinkedIn, Instagram |
| Wednesday | Product/Feature | All platforms |
| Thursday | Community/UGC | Facebook, Instagram |
| Friday | Engagement/Poll | Twitter, Instagram |
| Saturday | Behind-the-scenes | Instagram, Facebook |
| Sunday | Curated/Planning | Repurpose content |

### Batch Creating Content
- Create content in batches (1 day/week)
- Use templates for consistency
- Repurpose across platforms
- Schedule in advance
- Leave room for trending topics

---

## Analytics & Optimization

### Key Metrics to Track
- **Reach**: How many saw it
- **Engagement Rate**: Interactions/Reach
- **Follower Growth**: Net new followers
- **Click-through Rate**: Link clicks/Reach
- **Save Rate**: Saves/Reach (Instagram)

### What to Test
- Posting times
- Content formats
- Hashtag combinations
- CTA styles
- Caption lengths

### Optimization Loop
1. Post content
2. Track metrics
3. Identify top performers
4. Analyze what worked
5. Apply learnings
6. Repeat

---

## Common Mistakes to Avoid

### Content Mistakes
- ❌ Only promotional content
- ❌ Posting without clear CTA
- ❌ Ignoring comments/messages
- ❌ Inconsistent posting schedule
- ❌ Not repurposing content

### Strategy Mistakes
- ❌ Chasing vanity metrics
- ❌ Ignoring analytics
- ❌ Not defining target audience
- ❌ Trying to be everywhere at once
- ❌ Not having a brand voice

### Engagement Mistakes
- ❌ Buying followers
- ❌ Using engagement pods
- ❌ Generic responses
- ❌ Not replying to DMs
- ❌ Only responding to positive feedback

---

## Pro Tips

### Content Repurposing
- 1 long-form content = 5+ social posts
- 1 video = Reel + Story + Twitter thread
- 1 blog post = Infographic + Quotes + Carousel

### Building Personal Brand
- Share professional journey
- Be consistent with posting
- Engage with industry leaders
- Provide value freely
- Show behind-the-scenes

### Automation Best Practices
- Automate scheduling (not engagement)
- Personalize automated responses
- Maintain human touch
- Don't over-automate
- Monitor all automated actions


path: references/platform_guidelines.md
content: # Platform Guidelines - Social Media Posting Rules

## Twitter/X

### Posting Rules
- **Character Limit**: 280 characters (hard limit)
- **Media Limit**: Up to 4 images, 1 GIF, or 1 video per tweet
- **Link Preview**: Automatically generated, counts as ~23 characters
- **Thread Limit**: Up to 25 tweets in a thread

### Best Practices
- Use hooks in first 50 characters
- Add 1-2 relevant hashtags
- Include 1 call-to-action
- Post 3-5 times daily maximum
- Optimal times: 9am, 12pm, 5pm (your audience's timezone)

### Content Guidelines
- Be concise and punchy
- Use emojis sparingly
- Share insights, not promotions
- Engage with replies within 1 hour
- Retweet relevant content daily

### What's Not Allowed
- Spam behavior (excessive posting, automation abuse)
- Duplicate content across accounts
- Misinformation
- Harassment or hate speech
- Copyrighted content without permission

---

## Instagram

### Posting Rules
- **Caption Limit**: 2,200 characters (hashtags included)
- **Hashtag Limit**: 30 hashtags maximum
- **Image Size**: 1080 x 1080 pixels (square), 1080 x 1350 (portrait)
- **Video Length**: 60 seconds (feed), 15 seconds (stories)
- **Reel Length**: 90 seconds maximum

### Best Practices
- Write hooks in first 125 characters (visible before "more")
- Use 11 hashtags for optimal reach
- Post to stories daily
- Use 5-10 relevant hashtags in first comment
- Respond to comments within 2 hours

### Content Guidelines
- High-quality, visually consistent images
- Carousel posts for educational content
- Reels for reach (favored by algorithm)
- User-generated content builds community
- Save-worthy content drives engagement

### Engagement Rate Benchmarks
- <1%: Low
- 1-3.5%: Average
- 3.5-6%: High
- >6%: Very High

### What's Not Allowed
- Mass following/unfollowing
- Comment pods (fake engagement)
- Watermarked content
- Misleading captions
- Excessive promotional content

---

## LinkedIn

### Posting Rules
- **Post Length**: 3,000 characters maximum
- **Optimal Length**: 700-1,500 characters
- **Hashtag Limit**: 3-5 hashtags recommended
- **Document Size**: PDF up to 100MB
- **Video Length**: 10 minutes maximum

### Best Practices
- Write personal stories or insights
- Use professional, authentic tone
- Post 2-5 times per week
- Include 3 relevant hashtags at end
- Engage with comments within 4 hours

### Content Types That Work
- Personal professional stories
- Industry insights and trends
- How-to guides and tips
- Company announcements
- Employee spotlights
- Industry memes (occasionally)

### Engagement Rate Benchmarks
- <1%: Low
- 1-2%: Average
- 2-4%: High
- >4%: Very High

### What's Not Allowed
- Fake engagement or bots
- Promotional spam
- Misleading content
- Harassment
- Copyright infringement

---

## Facebook

### Posting Rules
- **Post Length**: 63,206 characters (practically unlimited)
- **Optimal Length**: 80-150 words for organic reach
- **Video Length**: 240 minutes maximum
- **Hashtag Limit**: 1-3 hashtags (optional)
- **Image Size**: 1200 x 630 pixels (link), 1080 x 1080 (image)

### Best Practices
- Post 1-2 times daily maximum
- Use community-friendly tone
- Ask questions to drive comments
- Share behind-the-scenes content
- Respond within 2 hours

### Content Guidelines
- Short, scannable posts perform best
- Native video > shared links
- Images drive engagement
- Stories for daily presence
- Events for promotions

### Engagement Rate Benchmarks
- <0.5%: Low
- 0.5-1.5%: Average
- 1.5-3.5%: High
- >3.5%: Very High

### What's Not Allowed
- Engagement bait ("like if...")
- Misleading content
- Spam behavior
- False news
- Unauthorized copyrighted content

---

## Platform Comparison

| Feature | Twitter | Instagram | LinkedIn | Facebook |
|---------|---------|-----------|----------|----------|
| Character Limit | 280 | 2,200 | 3,000 | 63K |
| Optimal Hashtags | 1-3 | 5-15 | 3-5 | 1-3 |
| Posting Frequency | 3-5/day | 1-2/day | 2-5/week | 1-2/day |
| Video Max | 2:20 | 60s/90s | 10 min | 240 min |
| Best for | News, updates | Visual, lifestyle | B2B, professional | Community |

---

## Global Platform Rules

### Content That Violates All Platforms
- Hate speech and harassment
- Violence and gore
- Spam and scams
- Misinformation
- Copyrighted material (without license)
- Privacy violations
- Sexually explicit content
- Illegal activities

### General Best Practices
1. **Consistency** > Frequency
2. **Quality** > Quantity
3. **Engage** > Broadcast
4. **Authentic** > Perfect
5. **Value** > Promotion


path: scripts/example.py
content: #!/usr/bin/env python3
"""
Example helper script for social-media-manager

This is a placeholder script that can be executed directly.
Replace with actual implementation or delete if not needed.

Example real scripts from other skills:
- pdf/scripts/fill_fillable_fields.py - Fills PDF form fields
- pdf/scripts/convert_pdf_to_images.py - Converts PDF pages to images
"""

def main():
    print("This is an example script for social-media-manager")
    # TODO: Add actual script logic here
    # This could be data processing, file conversion, API calls, etc.

if __name__ == "__main__":
    main()


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)