Article Pipeline

End-to-end article delivery: markdown draft to X Articles-ready package.

Trigger: When you've written an article and need to prepare it for X Articles publishing.

What It Does

Takes a markdown article and produces:

1. Validated, formatted markdown (word count, structure check)
2. Rich HTML for X Articles clipboard paste
3. 5:2 banner image (fal.ai abstract + text overlay via Playwright)
4. Telegram delivery of both article + banner

Prerequisites

• FAL_API_KEY in ~/.axiom/wallet.env
• ffmpeg installed
• Python 3.9+ with Pillow, pyobjc-framework-Cocoa (for clipboard)
• npx playwright (for banner text overlay)
• x-article-publisher scripts at ~/.clawdbot/skills/x-article-publisher/scripts/

Usage

Full Pipeline (One Command)

# Deliver article + banner to Telegram
node ~/Github/axiom-public/agent-skills/skills/article-pipeline/scripts/pipeline.mjs \
  /tmp/article-draft.md \
  --banner-prompt "Dark abstract composition, neural network topology, black background" \
  --telegram  # outputs instructions for message tool delivery

Individual Steps

# 1. Validate article structure
node scripts/pipeline.mjs /tmp/article-draft.md --validate-only

# 2. Generate banner only
node scripts/pipeline.mjs /tmp/article-draft.md --banner-only \
  --banner-prompt "Dark abstract, geometric data flows"

# 3. Generate HTML for clipboard only
node scripts/pipeline.mjs /tmp/article-draft.md --html-only

Banner with Text Overlay

# Generate banner with custom overlay text
node scripts/pipeline.mjs /tmp/article-draft.md \
  --banner-prompt "Dark abstract, teal particles" \
  --banner-overlay "How I Built a Cron Fleet Manager" \
  --banner-subtitle "30 jobs. Zero manual intervention."

Output

The pipeline produces files in /tmp/article-pipeline/:

/tmp/article-pipeline/
├── article.md          # Validated markdown (em dashes stripped)
├── article.html        # Rich HTML for X Articles paste
├── banner-raw.png      # Raw fal.ai generation
├── banner.png          # Final 5:2 (1250x500) banner
└── manifest.json       # Metadata (word count, title, sections)

Article Rules (Enforced)

The validator checks:

• No em dashes (replaced with commas automatically)
• Under 1500 words
• Has H1 title
• Has at least 3 sections (H2 headers)
• Code blocks use real fenced syntax
• No AI slop phrases ("dive in", "landscape", "let's explore")

Integration with Build Crons

After shipping code, the build cron should:

1. Write article to /tmp/article-draft.md
2. Run pipeline: node pipeline.mjs /tmp/article-draft.md --banner-prompt "..." --telegram
3. Use OpenClaw message tool to send article text + banner to Telegram

Banner Design System

Banners follow Axiom's design aesthetic:

• Base: fal.ai abstract visual (cinematic, dark, no text)
• Overlay: HTML/CSS text via Playwright screenshot (optional)
• Fonts: Inter + JetBrains Mono (Google Fonts)
• Colors: #0a0a0a background, muted teal/amber accents
• Ratio: 5:2 (1250x500px) for X Articles