Skip to content

Social Media Content Generator Skill

Summary

This skill generates optimized social media preview images and Open Graph metadata for each page in the intelligent textbook, ensuring attractive, informative previews when pages are shared on social platforms, and creates a social media promotion campaign to increase textbook visibility.

Order

This skill should be executed:

  1. After chapter content is substantially complete (70%+ chapters written)
  2. After glossary and key pages exist
  3. Before major marketing or promotion efforts
  4. Can be re-run when content updates significantly

The generator creates custom social cards and promotional content, so it needs actual content to visualize and promote.

Inputs

Primary Input Files

  1. All Markdown Content (docs/**/*.md)
  2. Extracts titles, descriptions, key concepts
  3. Identifies visual elements to feature

  4. Quality check: Pages should have clear titles and meaningful content

  5. Learning Graph (docs/learning-graph/03-concept-dependencies.csv)

  6. Visualizes concept relationships in social cards
  7. Highlights key concepts for promotion

  8. Quality check: Valid graph structure

  9. MicroSims (docs/sims/*/)

  10. Screenshots or animated previews for social sharing
  11. Highlights interactive features

  12. Quality check: All MicroSims functional

  13. Course Description (docs/course-description.md)

  14. Source for course overview messaging
  15. Target audience identification

  16. Quality check: Clear, compelling description

  17. Site Configuration (mkdocs.yml)

  18. Site title, author, URL
  19. Existing social media configuration

  20. Quality check: Complete metadata fields

  21. Branding Assets (docs/img/)

  22. Logo for social cards
  23. Brand colors and style guide
  24. Quality check: Logo exists in high resolution

Optional Input Files

  1. Social Media Strategy (docs/social-media-strategy.json)
  2. Target platforms (Twitter, LinkedIn, Facebook, Reddit)
  3. Posting frequency and schedule
  4. Hashtag strategy

  5. Audience demographics

  6. Existing Social Cards (docs/img/social/)

  7. Previous cards for consistency checking
  8. Quality check: Consistent style maintained

Input Quality Metrics (Scale 1-100)

Content Readiness Score: - 90-100: Complete content, clear structure, compelling descriptions - 70-89: Most content ready, some pages lack descriptions - 50-69: Basic content but many pages lack compelling hooks - Below 50: Insufficient content for effective social promotion

Quality Checks:

  1. Page count: 20+ pages = good baseline for promotion
  2. Metadata completeness: Titles and descriptions for 90%+ pages
  3. Visual assets: Logo, favicon, cover image present
  4. Compelling hooks: Key value propositions clear in content
  5. Target audience: Clearly defined in course description

User Dialog Triggers: - Score < 60: "Limited content or metadata. Social cards may be generic. Continue or improve content first?" - No logo: "No logo found. Generate text-based social cards or provide logo first?" - No course description: "No compelling course description. Social promotion will be limited. Add description?" - Incomplete metadata: "[N] pages missing titles/descriptions. Generate with defaults or update content?"

Outputs

Social Media Assets

  1. Custom Social Cards (docs/img/social/[page-path].png)
  2. One 1200x630px image per important page
  3. Includes: page title, key visual, logo, branding
  4. Follows consistent design template

  5. Optimized for Open Graph and Twitter Cards

  6. Open Graph Metadata (injected into markdown frontmatter)

  7. Updates each markdown file with: 

    1
2
3
4
5
    ---
title: "Page Title"
description: "Compelling 155-character description"
image: img/social/page-path.png
---

  8. MicroSim Preview Videos/GIFs (docs/img/social/sims/[sim-name].gif)

  9. Animated previews of interactive simulations
  10. 10-15 second loops showing key interactions
  11. Optimized file size for fast loading

Promotional Content

  1. Social Media Posts (docs/social-media/posts.md)
  2. 20-30 pre-written posts for different platforms
  3. Organized by topic/chapter
  4. Includes hashtags, emojis, calls-to-action

  5. Platform-specific versions (Twitter, LinkedIn, Facebook, Reddit)

  6. Launch Campaign (docs/social-media/launch-campaign.md)

  7. Week-by-week rollout plan
  8. Sequence of posts building anticipation
  9. Highlights key features (MicroSims, learning graph, etc.)

  10. Engagement strategies

  11. Visual Quote Cards (docs/img/social/quotes/)

  12. 10-15 shareable images with key insights
  13. Branded design template
  14. Text overlays with important concepts
  15. Attribution and textbook link

Analytics & Tracking

  1. UTM Link Library (docs/social-media/utm-links.csv)
  2. Tracked links for each social post
  3. Campaign, medium, source parameters
  4. Organized by platform and content type

  5. For Google Analytics integration

  6. Social Media Analytics Template (docs/social-media/analytics-template.md)

  7. Metrics to track (clicks, shares, engagement)
  8. Reporting template
  9. Success criteria

Output Quality Metrics (Scale 1-100)

Social Card Quality Score:

  • Visual Design (25 points):
  • Professional, branded appearance
  • Readable text (minimum 30pt font)
  • High contrast for visibility
  • Consistent style across all cards
  • Proper logo placement

  • No text/image cutoff issues

  • Content Effectiveness (25 points):

  • Title clearly visible and compelling
  • Key visual supports the topic
  • Description provides value preview
  • Call-to-action implied or explicit

  • Unique for each page (not generic template)

  • Technical Quality (25 points):

  • Correct dimensions (1200x630px for OG, 1200x675px for Twitter)
  • File size < 1MB for fast loading
  • High resolution (300 DPI source, 72 DPI web)
  • Proper format (PNG or JPG)

  • Valid Open Graph markup

  • Platform Optimization (25 points):

  • Works on all major platforms (Facebook, Twitter, LinkedIn, Reddit)
  • Mobile preview looks good
  • Text readable at small sizes
  • Safe zones respected (no important content in edges)
  • Preview test successful on all platforms

Promotional Content Quality Score:

  • Messaging Effectiveness (30 points):
  • Clear value proposition
  • Engaging hooks and headlines
  • Benefits-focused (not feature-focused)
  • Appropriate tone for audience
  • Compelling calls-to-action

  • No jargon (unless target audience expects it)

  • Platform Appropriateness (25 points):

  • Character counts fit platform (Twitter 280, LinkedIn 3000, etc.)
  • Hashtag strategy appropriate (#education, #elearning, etc.)
  • Emoji use matches platform norms
  • Content style matches platform culture

  • Visual/text balance appropriate

  • Campaign Coherence (25 points):

  • Consistent narrative across posts
  • Logical sequence and pacing
  • Variety in content types (features, benefits, testimonials, visuals)
  • Strategic timing recommendations

  • Cross-promotion opportunities identified

  • Engagement Potential (20 points):

  • Questions and interactive elements
  • Share-worthy content (quotes, stats, visuals)
  • Conversation starters
  • Community building opportunities
  • User-generated content hooks

Social Media Post Categories

Feature Highlights (30%):

  • "Check out our interactive MicroSims for [topic]!"
  • "Navigate your learning path with our concept graph"
  • "Every term clearly defined in our comprehensive glossary"

Educational Content (25%):

  • "Did you know? [Interesting fact from textbook]"
  • "Quick tip: [Practical advice from content]"
  • "Concept breakdown: [Complex topic explained simply]"

Visual Content (20%):

  • MicroSim demonstrations
  • Learning graph visualizations
  • Infographics from chapters
  • Quote cards with key insights

Social Proof (15%):

  • User testimonials (when available)
  • Usage statistics
  • Case study highlights
  • Community contributions

Engagement Posts (10%):

  • Questions to community
  • Polls and surveys
  • Challenges and exercises
  • Discussion prompts

Platform-Specific Templates

Twitter/X: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
🎓 [Compelling hook]

[Key benefit in 1 sentence]

✨ Features:
• [Feature 1]
• [Feature 2]
• [Feature 3]

🔗 [Tracked link]

#EdTech #Education #[TopicSpecific] #OpenEducation

LinkedIn: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
[Professional headline]

[2-3 paragraph description of value]

Key Features:
→ [Feature with professional benefit]
→ [Feature with professional benefit]
→ [Feature with professional benefit]

This resource is perfect for:
• [Audience 1]
• [Audience 2]
• [Audience 3]

Explore now: [Tracked link]

#ProfessionalDevelopment #Education #[Topic]

Reddit (r/education, r/EdTech, topic-specific subs): 

1
2
3
4
5
6
7
8
9
[Authentic, informative title]

[Detailed, helpful description]

[What makes it unique/valuable]

[Link with context about being creator/contributor]

[Engage with comments genuinely]

Facebook: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
[Friendly, accessible tone]

[Emotional hook or story]

[Key benefits]

[Visual content embedded]

[Call to action with link]

#[RelevantHashtags]

Quality Checks Performed

  1. Social Card Validation:
  2. Dimensions correct for each platform
  3. File size optimized
  4. Text readable at thumbnail size
  5. Logo clearly visible
  6. No cut-off content

  7. Colors accessible (WCAG AA contrast)

  8. Open Graph Testing:

  9. Metadata valid in all frontmatter
  10. Preview test on Facebook Sharing Debugger
  11. Preview test on Twitter Card Validator
  12. Preview test on LinkedIn Post Inspector

  13. All images load correctly

  14. Content Review:

  15. No spelling/grammar errors
  16. Character counts within limits
  17. Hashtags relevant and not excessive (3-5 per post)
  18. Links tracked with UTM parameters

  19. Tone appropriate for platform and audience

  20. Brand Consistency:

  21. Visual style matches brand guidelines
  22. Messaging aligns with course values
  23. Logo usage correct
  24. Colors from brand palette

  25. Font choices consistent

  26. Accessibility:

  27. Alt text for all images
  28. Color contrast sufficient
  29. Text readable without images
  30. Captions for videos/GIFs
  31. Screen reader friendly

Success Criteria

Social Cards: - Overall quality score > 75 - 100% technical compliance (dimensions, file size) - Preview test successful on 4+ platforms - Consistent branding across all cards - Unique designs for major pages

Promotional Content: - Overall quality score > 70 - 20+ posts across multiple content types - Platform-specific optimization - Clear campaign strategy - Engagement hooks in 80%+ posts

Campaign Readiness: - Launch sequence defined (2-4 weeks) - Content calendar populated - UTM tracking configured - Analytics template ready - Success metrics defined

Additional Outputs

  1. Influencer Outreach List (docs/social-media/influencer-outreach.md)
  2. Relevant educators and EdTech influencers
  3. Personalized pitch templates

  4. Collaboration opportunities

  5. Community Engagement Guide (docs/social-media/community-engagement.md)

  6. How to respond to comments
  7. Building community around textbook
  8. User-generated content strategies

  9. Moderation guidelines

  10. A/B Testing Framework (docs/social-media/ab-testing.md)

  11. Headline variations to test
  12. Visual alternatives
  13. Call-to-action options

  14. Metrics to compare

  15. Evergreen Content Calendar (docs/social-media/evergreen-calendar.md)

  16. Posts that can be reused periodically
  17. Seasonal content opportunities
  18. Anniversary/milestone posts
  19. Update and refresh schedule

Configuration Options

Social Card Styles:

  • Minimal (text + logo + color)
  • Visual (concept illustration + text)
  • Data (graph visualization + stats)
  • Screenshot (MicroSim preview + description)

Campaign Intensity:

  • Soft launch (1-2 posts/week, 4 weeks)
  • Standard launch (3-5 posts/week, 3 weeks)
  • Blitz launch (daily posts, 2 weeks)

Target Platforms:

  • Academic focus (Twitter, LinkedIn, Reddit academic subs)
  • General education (Facebook, Instagram, Pinterest)
  • Technical audience (Hacker News, dev.to, technical subs)
  • All platforms (comprehensive strategy)

Automation Level:

  • Full automation (scheduled posts via Buffer/Hootsuite)
  • Semi-automated (drafts prepared, manual posting)
  • Manual (content created, posting strategy provided)