Social Content Generator

Generate social media content (posts, captions, images) for multiple platforms. Use when creating social media posts, marketing content, or bulk content cale...

Security Scan

The skill generally matches a social-post generator, but there are inconsistencies (missing referenced scripts, undeclared required credentials, and undocumented dependencies) that merit caution before installing or running it.

Purpose & Capability

Name/description match the included generate_post.py (AI text + optional image generation). However SKILL.md describes additional scripts (generate_calendar.py, upload_post.py) and platform-upload capabilities that are not present in the file manifest, which is inconsistent with the claimed multi-script capability.

Instruction Scope

SKILL.md instructs use of .env variables (OPENAI_API_KEY and platform API tokens) and references calendar and upload scripts. The only runnable file is generate_post.py which does use OpenAI and may call out to download images, but the manifest and registry declare no required env vars. The instructions thus ask the agent/user to provide credentials that the skill metadata doesn't declare, and they reference files that are missing.

Install Mechanism

This is an instruction-only skill with a single Python script (no install spec). The script imports third-party packages (openai, requests) but the package/dependency list is not declared. That omission is a distribution/maintenance risk (users may run it without required libs). No remote download URLs or obfuscated installers are present.

Credentials

SKILL.md expects sensitive API credentials (OPENAI_API_KEY, Twitter/Instagram/LinkedIn tokens) but the skill metadata declares no required environment variables or primary credential. Requesting or instructing use of multiple platform tokens is plausible for an uploader, but because upload functionality is only described (not included) and the manifest doesn't declare credential needs, the credential scope and disclosure are under-specified and inconsistent.

Persistence & Privilege

always is false and the skill does not request system-wide changes or persistent/automatic installation. It does not attempt to modify other skills' configs. Default autonomous invocation is allowed (normal) and not combined with other high-risk flags.

What to consider before installing

This skill appears to be a legitimate social-post generator, but there are several red flags you should address before using it: - Missing files: SKILL.md references generate_calendar.py and upload_post.py but only generate_post.py is included. Ask the author for the missing scripts or remove references if they're not part of the package. - Undeclared credentials: The README/skill suggests you must provide OPENAI_API_KEY and platform tokens, yet the registry metadata lists no required env vars. Treat API keys as sensitive—only provide them after confirming exactly which script needs them and why. - Undeclared dependencies: The script uses the openai and requests Python packages but the skill provides no install/dependency spec. Install dependencies in a virtualenv and inspect the code before running. - Network behavior: generate_post.py will call OpenAI and download images from URLs returned by the API. This is expected for image/text generation, but be aware that your prompt/topic content and any generated content will be sent to OpenAI. Use limited-scope API keys and quotas. - Safety steps: run the script in an isolated environment (container or VM), avoid hardcoding tokens or committing .env to repos, restrict API key scopes where possible, and ask the publisher to provide: (1) complete file set, (2) a requirements.txt or install instructions, and (3) explicit documentation for which env vars are actually needed. If the uploader feature is required, request the upload_post.py source for review before providing platform credentials. If you want, I can (a) inspect any missing scripts you obtain, (b) produce a safe requirements.txt and minimal run instructions, or (c) point out exact lines where environment variables are referenced inside the code.

Overview

AI-powered social media content creation skill. Generates platform-optimized posts with text and images using OpenAI models. Supports bulk generation and content calendars.

Supported Platforms

Platform	Text Limit	Image Ratio	Hashtags
Twitter/X	280 chars	16:9, 1:1	2-3
Instagram	2200 chars	1:1, 4:5, 9:16	5-15
LinkedIn	3000 chars	1.91:1, 1:1	3-5
Facebook	63206 chars	1.91:1, 1:1	1-3

Quick Start

Generate Single Post

python scripts/generate_post.py \
  --platform twitter \
  --topic "AI productivity tools" \
  --tone professional \
  --include-image

Generate Content Calendar

python scripts/generate_calendar.py \
  --config config.json \
  --output calendar_output/

Scripts

generate_post.py

Generate a single social media post with optional image.

Arguments:

• --platform - Target platform (twitter, instagram, linkedin, facebook)
• --topic - Post topic/theme
• --tone - Writing tone (professional, casual, funny, inspirational)
• --include-image - Generate accompanying image
• --image-prompt - Custom image prompt (auto-generated if not provided)
• --output - Output directory (default: current dir)

Output:

• post.txt - Generated text content
• image.png - Generated image (if requested)
• metadata.json - Post metadata

generate_calendar.py

Generate a week/month of content in bulk.

Arguments:

• --config - JSON config file with topics and schedule
• --output - Output directory
• --platforms - Target platforms (comma-separated)

upload_post.py (Optional)

Upload generated posts to social platforms via API.

Requirements:

• Platform API credentials in .env file
• Twitter API v2, Instagram Graph API, LinkedIn API

Configuration

Environment Variables (.env)

# OpenAI for text generation
OPENAI_API_KEY=sk-...

# For image generation (if using OpenAI)
OPENAI_API_KEY=sk-...

# Platform APIs (optional, for auto-upload)
TWITTER_BEARER_TOKEN=...
TWITTER_API_KEY=...
TWITTER_API_SECRET=...
INSTAGRAM_ACCESS_TOKEN=...
LINKEDIN_ACCESS_TOKEN=...

Content Calendar Config (JSON)

{
  "brand": {
    "name": "Your Brand",
    "voice": "professional yet friendly",
    "topics": ["AI", "productivity", "tech news"]
  },
  "schedule": {
    "twitter": {"frequency": "daily", "times": ["09:00", "15:00"]},
    "instagram": {"frequency": "3x/week", "times": ["11:00"]},
    "linkedin": {"frequency": "2x/week", "times": ["08:00"]}
  },
  "content_mix": {
    "educational": 40,
    "promotional": 20,
    "engagement": 25,
    "curated": 15
  }
}

Post Templates

Twitter/X

[Hook/Question]

[Main content - 1-2 sentences]

[Call-to-action or insight]

#Hashtag1 #Hashtag2

Instagram

[Emoji] [Attention-grabbing opener]

[Story/value proposition - 2-4 sentences]

[Benefits/features]

[Call-to-action]

[Relevant hashtags: 5-15]

LinkedIn

[Professional hook or insight]

[Detailed content - story, data, or analysis]

[Key takeaway]

[Question for engagement]

#Industry #Topic #Professional

Best Practices

1. Platform optimization - Each platform has different norms and limits
2. Visual consistency - Maintain brand colors and style in images
3. Engagement hooks - Start with questions or bold statements
4. Call-to-action - Always include a CTA (comment, share, click, etc.)
5. Hashtag strategy - Mix popular and niche hashtags
6. Posting timing - Schedule for peak engagement hours

Example Outputs

Twitter Post

🚀 Just discovered an AI tool that saves me 2 hours daily.

It automates my entire content workflow: research → draft → edit → schedule.

The best part? It learns my writing style over time.

What's your favorite productivity tool?

#AI #Productivity #ContentCreation

Instagram Caption

✨ Monday Motivation ✨

Your competition isn't other creators. It's the distraction in your pocket.

Every scroll, every notification, every "quick check" steals from your focus.

This week, try:
• Phone in another room while working
• 90-min deep work blocks
• Batch your social media time

Your future self will thank you. 💪

What's your biggest focus killer?

#MondayMotivation #Productivity #DeepWork #FocusTips #ContentCreator #AI #WorkSmart

Troubleshooting

• Image generation fails: Check API key and quota
• Text too long: Adjust topic scope or use summarize option
• Platform API errors: Verify credentials and permissions
• Rate limits: Add delays between bulk generations