SKILL: Social Media Manager

Goal

Automate the creation and scheduling of high-engagement social media content across any platform (TikTok, Instagram, X/Twitter, LinkedIn, Facebook, YouTube, and more) using AI generation and the Postiz API.

Supported Platforms

Postiz supports multi-platform publishing. Any platform you connect in Postiz can be targeted:

• TikTok — Slideshows, carousels, short videos
• Instagram — Reels, carousels, single-image posts
• X / Twitter — Text posts, image threads
• LinkedIn — Articles, image posts, carousels
• Facebook — Posts, stories, reels
• YouTube — Shorts, community posts
• Pinterest, Reddit, Threads, and more as Postiz adds integrations

Workflow

1. Research & Ideation: Brainstorm hooks using the "Conflict Formula": [Person] + [Conflict/Doubt] -> [AI Solution] -> [Resolution].
2. Content Generation: Use AI to generate platform-appropriate content.
   • Images/Slides: AI-generated visuals (e.g., Nano Banana Pro, gpt-image-1.5) at platform-optimal resolutions.
   • Text: AI-written captions, threads, or articles tailored to each platform's tone and format.
   • Video thumbnails: AI-generated cover images for video content.
3. Platform Adaptation: Adjust content format per platform:
   • TikTok/Instagram: Portrait 1024x1536, 6-slide carousels
   • X/Twitter: Landscape/square images, concise text
   • LinkedIn: Professional tone, landscape images
   • YouTube Shorts: Portrait video thumbnails
4. Consistency Check: Ensure "locked architecture" (same subject/theme, different styles).
   • Critical: Write one detailed description of the subject and reuse it in EVERY prompt. Only change the style/lighting/context.
5. Scheduling & Publishing: Upload and schedule via Postiz API.
   • Draft mode (SELF_ONLY) for review before publishing.
   • Scheduled posts for optimal engagement times.
   • Cross-post the same content across multiple platforms simultaneously.
6. Notification: Ping user with the caption and links to review/publish.

Postiz API Integration

Postiz acts as the universal publishing layer. One API handles all connected platforms.

Configuration

• API URL: https://api.postiz.com/public/v1
• Auth Header: Authorization: <API_KEY> (No Bearer prefix).
• Media Upload: POST /upload first to get id and path.
• Posting Method: Use UPLOAD (Draft) for multi-image content. DIRECT_POST works for single-image/text posts.

Posting Structure

• Top level: type ("now" or "schedule"), date (ISO 8601), posts (array).
• Post level: integration: { id: "..." }, value: [ { content: "...", image: [ { id, path } ] } ].
• Settings level: Platform-specific settings (e.g., __type: "tiktok", __type: "instagram", etc.).

Technical Specs

• Upload Media: curl -X POST {API_URL}/upload -H "Authorization: {KEY}" -F "file=@path/to/file"
• Create Post: curl -X POST {API_URL}/posts -H "Authorization: {KEY}" -H "Content-Type: application/json" -d '{...}'
• List Integrations: curl {API_URL}/integrations -H "Authorization: {KEY}" — use this to discover connected platforms and their integration IDs.

Prompt Strategy

The Conflict Formula

Adaptable to any product, service, or brand:

• [Person] + [Common Pain Point] -> [Your Solution] -> [Success/Resolution]
• Identify 4-6 pain points per product for content variety.
• Each pain point becomes a unique content series.

Slide/Carousel Structure

• Slide 1: The "Before" or "Conflict" state + Hook Text Overlay
• Slides 2-5: The "Transformation" or style options
• Slide 6: The "Final Result" / Call to Action

Success Log

• 2026-02-14: Posted "Rejected TWICE" carousel (6 slides, Conflict Formula). Fixed API fields: duet/stitch/comment (booleans), autoAddMusic ("yes"/"no"), brand_content_toggle/brand_organic_toggle (booleans). Top-level shortLink (bool) and tags (array) required.
• 2026-02-13: Successfully transitioned to UPLOAD method for TikTok slideshows. Confirmed that DIRECT_POST triggers ERROR state for multi-image sequences.

Failure Log

• 2026-02-13: API Authentication requires Authorization: <KEY> (no Bearer).
• 2026-02-13: Postiz requires content_posting_method and privacy_level in settings.
• 2026-02-13: Draft upload via Postiz requires valid media URLs (uploads.postiz.com) and correct posts array structure.