x-article-draft-uploader

Upload Obsidian or local Markdown articles to X Articles as drafts with Playwright.

1.8k|235|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mcncarl/yichen-skills --skill x-article-draft-uploader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-article-draft-uploader
Source: https://github.com/mcncarl/yichen-skills/tree/main/x-article-draft-uploader
Command: npx skills add https://github.com/mcncarl/yichen-skills --skill x-article-draft-uploader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, pycryptodome, and includes scripts (resource) components.

What problem does it solve?

This skill automates converting Obsidian or local Markdown articles into X Articles drafts, ensuring the first image is used as the cover and all content images are inserted at their original locations, eliminating manual uploading steps and layout correction.

Core Features & Use Cases

  • Automates draft creation on X Articles using independent Playwright sessions, avoiding interference with the user's active browser.
  • Validates cover image presence; preserves image order and anchor placement to mirror the Markdown layout; supports no-cover workflows with the --allow-no-cover option.
  • Safely handles cookies by exporting and loading them locally without storing credentials in the skill repository; includes a dry-run mode to verify before publishing.
  • Supports dry-run, cover upload, title/body paste, and multiple body images with accurate anchors.

Quick Start

Export your X cookies to a temporary file and run the dry-run to validate cover and image placement before uploading.

Frequently Asked Questions about x-article-draft-uploader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate uploading Markdown articles to X Articles drafts?

You can automate uploading Markdown articles to X Articles drafts by running a Playwright script that extracts local images, sets the first as the cover, and inserts remaining images at their original anchors.

How does the cover image selection work when publishing Markdown to X Articles?

The cover image selection works by extracting the first image found in your Markdown file and uploading it as the X Articles cover, while all subsequent images are inserted into the body at their original positions.

Can I use Playwright to publish drafts to X Articles without hijacking my active browser?

Yes, you can use Playwright to publish drafts to X Articles without hijacking your active browser because the skill runs independent Playwright sessions that operate separately from your active browser.

Does the X Articles draft uploader require storing my login credentials?

No, the X Articles draft uploader does not require storing your login credentials because it exports and loads cookies locally from a temporary file to authenticate your session.

What is the best way to validate image placement before publishing an X Articles draft?

The best way to validate image placement before publishing an X Articles draft is using the dry-run mode, which verifies cover presence and image anchor positions without uploading to the platform.

What happens if my Markdown article does not have an image for the cover?

If your Markdown article does not have an image for the cover, the skill enforces cover validation by default, but you can bypass this using the --allow-no-cover option to proceed with the draft upload.