home / skills / cdeistopened / opened-vault / x-article-converter

x-article-converter skill

safe

This skill converts blog posts into X/Twitter articles with handles and a posting strategy to boost reach and engagement.

npx playbooks add skill cdeistopened/opened-vault --skill x-article-converter

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

3.0 KB

---
name: x-article-converter
description: Convert blog posts or newsletters into X/Twitter articles with handles inserted and a posting strategy. Use when the user wants to turn an article into X content, create a tweetstorm, or promote content on Twitter/X with expert tagging. (project)
---

# X Article Converter

Transform blog posts and newsletters into X/Twitter-ready content with handles and a posting strategy.

## Workflow

### Step 1: Identify People and Companies

Read the source article and extract all:
- Named individuals (authors, experts quoted, founders)
- Companies/organizations mentioned
- Platforms/products referenced

### Step 2: Find Twitter Handles

Use WebSearch to find Twitter/X handles for each person and company:

```
Search: "[Name] twitter" or "@[Name] site:twitter.com"
```

Create a handle reference table:

| Name | Handle | Role |
|------|--------|------|
| Justin Skycak | @justinskycak | Math Academy, quoted |

If no handle found, note "No handle found" and skip tagging.

### Step 3: Create the X Article Version

Duplicate the original article and insert handles at **first mention only**:

- Before: "Justin Skycak, Director of Analytics at Math Academy..."
- After: "@justinskycak (Justin Skycak), Director of Analytics at @_MathAcademy_..."

Keep handles natural - don't force them where they break flow.

### Step 4: Create Launch Tweet Options

Write 3 ranked tweet options for the main article launch. Each should:
- Hook with the strongest insight or stat
- Tag 1-2 key people who might RT
- Include article link
- Stay under 280 chars (or use thread format)

Rank by: likelihood of engagement from tagged people.

### Step 5: Create Weekly Posting Schedule

For each major expert/company in the article, write a standalone post:

| Day | Expert | Angle |
|-----|--------|-------|
| Mon | [Name] | [Specific insight from their quote] |
| Tue | [Name] | [Different angle] |

Each standalone post should:
- Feature one person's insight
- Tag them directly
- Stand alone without requiring the full article
- Link back to article

### Step 6: Output Files

Save to the same folder as the source article:

1. `[Article-Name]-X-Article.md` - Full article with handles
2. `[Article-Name]-Social-Assets.md` - Contains:
   - Handle reference table
   - 3 ranked launch tweets
   - Weekly posting schedule with standalone posts
   - Posting notes for handoff

## Output Format

### Social Assets File Structure

```markdown
# [Article Name] - Social Media Assets

**Article:** [link]
**Date:** [date]

**Handoff Notes:**
- [Key instruction for assistant]
- [Who agreed to RT, if any]

---

## Twitter/X Handles

| Person | Handle | Role |
|--------|--------|------|

---

## MAIN LAUNCH TWEETS (Pick One)

### #1 PICK: [Label]
> [Tweet text]

**Why this one:** [Reasoning]

---

## WEEKLY SCHEDULE

### MONDAY: [Name]
**Angle:** [What makes this post unique]

> [Tweet text]

---
```

## Keep It Simple

- One file for the X article version
- One file for posting strategy
- Handle reference table at top of both
- Clear handoff notes so assistant knows what to do

Overview

This skill converts blog posts and newsletters into X/Twitter-ready articles, tweetstorms, and a practical posting strategy. It inserts verified handles at first mentions, produces ranked launch tweets, and builds a weekly schedule of standalone posts to maximize reach. The output is two simple files: an X article with handles and a social-assets file with the handle table, tweets, schedule, and handoff notes.

How this skill works

I read the source article to extract named people, companies, and products, then search for their X/Twitter handles. I insert handles naturally at first mention in the article copy and skip tagging when no handle is found. I write three ranked launch tweet options, and create a weekly posting schedule that turns each expert quote into a standalone post linking back to the article.

When to use it

You want to turn a long-form article or newsletter into X-friendly content quickly.
You need a tweetstorm or concise launch tweets that tag relevant experts to boost engagement.
You want a week-long posting plan that highlights different experts or angles.
You need handoff-ready social assets for a community manager or PR partner.

Best practices

Only tag handles at the first mention to keep prose natural and avoid clutter.
Prioritize tagging 1–2 high-value handles per launch tweet for higher RT potential.
Verify handles via search results or the platform profile before tagging.
Keep each standalone post self-contained and link back to the full article.
Rank launch tweets by expected engagement from tagged accounts and clarity of hook.

Example use cases

Convert a product announcement blog into an X article and three launch tweets that tag founders and partners.
Turn an expert roundup newsletter into a week of standalone posts featuring each quoted source.
Produce a tweetstorm from a data-driven article with the most surprising stat as the hook.
Create handoff-ready social assets for a PR team including a handle table and posting calendar.

FAQ

What if I can’t find a handle for someone mentioned?

Note "No handle found" in the handle table and omit tagging; still reference the person by name in the article.

How many handles should I tag per tweet?

Limit to 1–2 high-priority handles per launch tweet to avoid clutter and increase the chance of retweets.