Skip to content

heymegabyte/agent-skills / 09-brand-and-content-system

brand-and-content-system

Verified

Extract real brands (Wayback for rebuilds). Copy system, headline/CTA rules, trust surfaces, legal pages, SEO+structured data, anti-AI-slop, microcopy, DESIGN.md, W3C DTCG tokens, pSEO 5 types, GEO/AI search.

FileKindSize
SKILL.mdskill md12.2 KB
ai-search-geo.mdmarkdown4.0 KB
build-breaking-rules.mdmarkdown21.0 KB
documentation-and-codebase-hygiene.mdmarkdown3.1 KB
email-templates.mdmarkdown6.0 KB
grammar-audit.mdmarkdown3.7 KB
per-route-metadata.mdmarkdown6.8 KB
seo-and-keywords.mdmarkdown6.3 KB
social-automation.mdmarkdown5.8 KB

social-automation.md

View on GitHub
---
name: "Social Automation"
version: "1.1.0"
updated: "2026-04-23"
description: "Auto-post via Postiz (self-hosted Coolify) on deploy. X/Twitter, LinkedIn, Reddit, GitHub, Threads, TikTok, Pinterest+. Platform-specific copy in Brian's voice, OG images, Playwright verification."
---

# Social Automation via Postiz

## Postiz Instance

- **URL** — https://postiz.megabyte.space
- **Connected platforms** — X/Twitter, LinkedIn, Reddit, GitHub, Threads, Facebook, TikTok, Pinterest, Dribbble, Discord, Slack, Mastodon, Telegram, Beehiiv

## When to Auto-Post

- New product launch (first deploy of a domain)
- Major feature additions (new sections, new integrations)
- Milestone achievements (donation goals met, impact numbers)
- **NOT for** — bug fixes, style tweaks, skill updates, internal changes

## Post Generation

1. Summarize the change in 1-2 sentences (Brian's voice — sharp, punchy)
2. Include the site URL
3. Include the OG image URL for visual preview
4. Add relevant hashtags (max 5)
5. Customize per platform:
   - **X/Twitter** — 280 chars max, punchy, 2-3 hashtags
   - **LinkedIn** — professional tone, 1-2 paragraphs, link in body
   - **Reddit** — subreddit-appropriate title, link post
   - **Facebook** — casual, include image, tag @HeyMegabyte

## Postiz API

```bash
# Create a post
curl -X POST "https://postiz.megabyte.space/api/posts" \
  -H "Authorization: Bearer POSTIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Post text here",
    "platforms": ["twitter", "linkedin"],
    "media": ["https://domain.com/og-image.png"],
    "schedule": "now"
  }'
```

## Quality Verification

After posting, verify the post rendered correctly:

1. Get the public share URL from the Postiz API response
2. Playwright screenshot the share URL
3. Verify image loaded, text not truncated, link works
4. If issues found — debug, fix, repost

## Iterative Improvement

Track which posts get engagement: which platforms drive traffic, which formats engage, which times perform best. Log in PostHog.

## Coolify Access

Postiz runs on Coolify. If the API is down:

1. Check Coolify status — `curl coolify.megabyte.space/api/v1/services`
2. Restart via Coolify API if needed
3. Log the outage

## MCP Tools Available

### Postiz MCP (`mcp__postiz__*`)

- **`integrationSchedulePostTool`** — schedule a post to connected platforms with date / time
- **`integrationList`** — list all connected platform integrations
- **`integrationSchema`** — get schema for a specific integration (required fields, limits)
- **`generateImageTool`** — generate social preview images with AI
- **`generateVideoTool`** — generate short video clips for social
- **`generateVideoOptions`** — get available video generation options
- **`videoFunctionTool`** — execute video processing functions
- **`triggerTool`** — trigger immediate post (bypass scheduling)
- **`ask_postiz`** — ask Postiz AI for post copy suggestions

### Coolify MCP (`mcp__coolify__*`) — for Postiz service health

- **`diagnose_app`** — diagnose Postiz service health
- **`get_service`** — get Postiz service details
- **`control`** — restart Postiz if it's down

### PostHog MCP (`mcp__posthog__*`) — for engagement tracking

- **`authenticate`** — connect to PostHog for social analytics

## Posting Workflows

### Launch Day Social Sequence

When a new site launches, execute this sequence:

1. **T+0 min** — Post to X/Twitter (highest immediacy audience)
2. **T+15 min** — Post to LinkedIn (professional framing)
3. **T+30 min** — Post to Reddit (relevant subreddit, link post)
4. **T+1 hr** — Post to Facebook, Threads (broader reach)
5. **T+2 hr** — Post to Discord, Slack channels

```typescript
// Example: Schedule the full launch sequence
const platforms = ['twitter', 'linkedin', 'reddit', 'facebook', 'threads'];
const delays = [0, 15, 30, 60, 120]; // minutes

for (let i = 0; i < platforms.length; i++) {
  const scheduleTime = new Date(Date.now() + delays[i] * 60000);
  // Use mcp__postiz__integrationSchedulePostTool with platform + scheduleTime
}
```

### Social Preview Image Generation

Before posting, generate an OG-quality social image:

1. Call `mcp__postiz__generateImageTool` with site title + tagline
2. If custom image exists (OG image from site), use that instead
3. Verify image dimensions — 1200×630 for OG, 1080×1080 for Instagram / Threads
4. Fallback — screenshot the hero section via Playwright at 1200×630

## Computer Use Integration

Use `mcp__computer-use__*` tools for visual verification of posted content:

1. **Post verification** — after scheduling via MCP, open the platform in browser and screenshot to confirm the post rendered with correct image, text, and link
2. **Engagement monitoring** — screenshot Postiz dashboard at `https://postiz.megabyte.space` to check engagement metrics after 24 hours
3. **Platform-specific debugging** — if a post looks wrong on a specific platform, screenshot the live post to diagnose formatting issues

```
Workflow: Post → Wait 60s → Screenshot platform → AI visual check → Flag issues
```

## Acceptance Criteria

1. Post reaches all specified platforms — `mcp__postiz__integrationList` confirms connected, API returns 200 per platform
2. OG image renders correctly — Playwright screenshot of share URL shows image loaded (not broken / missing)
3. Text not truncated — post text is within platform character limits (280 X, 3000 LinkedIn, 300 Reddit title)
4. Link is clickable and resolves — fetch the URL in the post body, confirm 200 response
5. Hashtags present and relevant — 2-5 hashtags per post, no banned / spam tags
6. Launch sequence timing correct — posts staggered per the launch day sequence (not all simultaneous)
7. No duplicate posts — check Postiz post history, no identical content within 24 hours
8. PostHog event tracked — `social_post_published` event fires with platform + URL properties
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall