Skills x-article-publisher

📝

x-article-publisher

Name: x-article-publisher
Author: ZhanlinCui

Safe

Publish to X Articles from Markdown

Also available from: wshuyi

Automate publishing Markdown articles to X (Twitter) Articles with proper rich text formatting. Converts Markdown to HTML and handles image placement automatically using block index positioning.

Supports: Claude Codex Code(CC)

🥉 75 Bronze

Download the skill ZIP

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

Toggle on and start using

Test it

Using "x-article-publisher". Publish my article at ~/blog/my-post.md to X Articles

Expected outcome:

Successfully parsed Markdown file. Extracted title 'My Blog Post', cover image '~/blog/images/cover.jpg', and 3 content images. HTML copied to clipboard. Navigate to X Articles editor to paste content.

Using "x-article-publisher". Parse /tmp/article.md --html-only

Expected outcome:

HTML output: <h2>Section Title</h2><p>Paragraph with <strong>bold</strong> and <em>italic</em> text.</p><ul><li>List item 1</li><li>List item 2</li></ul>

Security Audit

Safe

v1 • 2/24/2026

Static analysis flagged 97 potential issues, but all are false positives. The skill uses standard Playwright browser automation and Python helper scripts for markdown parsing and clipboard operations. All external command references are documentation examples in markdown code blocks, not actual shell execution. URLs are legitimate X/Twitter endpoints. No confirmed security risks identified.

Files scanned

855

Lines analyzed

findings

Total audits

Medium Risk Issues (1)

External Command Documentation (False Positive)

Static scanner flagged 67 instances of shell commands in SKILL.md. These are all documentation examples in markdown code blocks, not actual code execution. Example: `python parse_markdown.py article.md` is a documented usage example.

Low Risk Issues (3)

SKILL.md:147 SKILL.md:158 SKILL.md:302

Hardcoded URLs (Expected Behavior)

Static scanner flagged hardcoded URLs like https://x.com/compose/articles. These are legitimate X/Twitter URLs for the article editor, which is the skill's intended target.

scripts/copy_to_clipboard.py:127-128 scripts/parse_markdown.py:287-288

Argparse Misidentified as Cryptography (False Positive)

Static scanner flagged argparse.ArgumentParser as 'weak cryptographic algorithm'. This is incorrect - argparse is Python's standard CLI argument parsing library, not cryptography.

Standard File Paths Flagged as Hidden/Temp Access (False Positive)

Static scanner flagged ~/.claude/skills/ and /tmp/ as hidden files and temp directory access. These are standard Claude Code skill paths and normal temp file locations.

Audited by: claude

Quality Score

Architecture

100

Maintainability

Content

Community

Security

Spec Compliance

What You Can Build

Bloggers and Content Creators

Writers who maintain blogs in Markdown can directly publish to X Articles without manual copying and formatting.

News and Update Publishers

Publishers who need to quickly share formatted articles on X without the X web editor's limitations.

Automation Enthusiasts

Users who want to integrate X Article publishing into their automated content pipelines.

Try These Prompts

Basic Article Publishing

Use the x-article-publisher skill to publish my Markdown file at /path/to/article.md to X Articles.

Article with Images

Publish the article in /path/to/blog-post.md to X Articles. Make sure to include all images with proper positioning.

Draft for Review

Parse my article at /path/to/draft.md and prepare it for X Articles. Save as draft, do not publish.

Batch Publishing

I have multiple Markdown articles in /articles/ folder. Use x-article-publisher to prepare them for X Articles publishing.

Best Practices

Always save as draft first - never auto-publish without user confirmation
Use block_index for image positioning instead of text matching for reliability
Prepare all data (parse markdown, generate HTML) before starting browser automation to minimize wait times
Test with a sample article first to verify image placement before processing important content

Avoid

Do not attempt to auto-publish - this violates X terms and user trust
Avoid using text matching for image positioning - block_index is more reliable
Do not skip the draft review step - always let user verify before publishing
Avoid excessive browser_wait_for calls - most elements are immediately available after page load

Frequently Asked Questions

Does this skill require X Premium?

Yes, X Articles feature requires X Premium Plus subscription. The skill will prompt you if login is needed.

Can I auto-publish articles?

No, the skill is designed to always save as draft for user review. Auto-publishing is disabled for safety.

What Markdown features are supported?

Headers (H2, H3), bold, italic, links, ordered/unordered lists, blockquotes, and images are supported. Code blocks are converted to blockquotes.

How does image positioning work?

The skill uses block_index - each image has an index indicating which block element it should be inserted after. This is more reliable than text matching.

What platforms are supported?

The skill works on macOS due to clipboard dependencies (pyobjc). The Python scripts can run on any platform but clipboard copying requires macOS.

Can I use this with Claude Code?

Yes, this skill is designed for Claude Code and uses Playwright MCP for browser automation. It works with Claude, Codex, and Claude Code.