# Publish Markdown to X Articles

Publishing Markdown to X Articles requires careful formatting, image placement, and account navigation. This skill converts articles, prepares media, and guides a draft-only publishing workflow.

## Install

```bash
npx skillstore add wshuyi/x-article-publisher
```

## Metadata

- Status: approved
- Slug: wshuyi-x-article-publisher
- Skillstore revision: r1
- Version status: missing
- Tree hash: 15d04ccd917a8113fb1971b80ac02abf3fb87d4054fd27982347a7801d993b1a
- Author: wshuyi
- GitHub username: wshuyi
- License: MIT
- Repository: https://github.com/wshuyi/x-article-publisher-skill/tree/main/skills/x-article-publisher/
- Ref: 64ca8af0f54a325752f08bd54e52151061ea659a
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, filesystem, external\_commands
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/wshuyi-x-article-publisher
- Manifest: https://skillstore.pages.dev/api/skills/wshuyi-x-article-publisher/manifest

## Capabilities

- Extracts article titles, cover images, and content image positions from Markdown files.
- Converts Markdown headings, lists, links, quotes, and bold text into rich HTML for X Articles.
- Guides navigation to the X Articles editor and starts a new draft.
- Uses the system clipboard to paste generated HTML and local images into the editor.
- Places content images by block index so image order stays consistent.
- Stops at draft review and does not publish the article automatically.

## Use Cases

- Draft Technical Articles: Convert Markdown tutorials into X Articles drafts while preserving headings, lists, links, and image placement.
- Republish Blog Posts: Move existing Markdown blog posts into X Articles without rebuilding the layout manually.
- Prepare Image-Heavy Essays: Insert multiple local images after the correct text blocks by using extracted block positions.

## Prompt Templates

### Create a Draft

```
Publish this Markdown file to X Articles as a draft: /path/to/article.md
```

### Review Article Assets

```
Parse /path/to/article.md and summarize the title, cover image, and content image positions before opening X.
```

### Check Formatting Changes

```
Convert /path/to/article.md for X Articles and tell me which formatting may change.
```

### Run the Full Draft Workflow

```
Prepare /path/to/article.md, paste the article into X Articles, insert images from highest block index to lowest, and stop at draft review.
```

## Limitations

- Requires a logged-in X account with access to X Articles.
- Requires browser automation tools and local Python dependencies.
- Works with Markdown files and local image references, not remote publishing feeds.
- Does not schedule posts, publish automatically, or provide engagement analytics.

## Best Practices

- Review the parsed title, cover image, and content image positions before opening the editor.
- Insert content images from highest block index to lowest block index.
- Keep the final article as a draft until the account owner reviews it.

## Anti Patterns

- Do not publish automatically from a logged-in X account.
- Do not rely on repeated text matching when block indices are available.
- Do not paste unreviewed generated content into a public account.

## Security Audit

- Audited at: 2026-07-08T12:21:27.346\+00:00
- Summary: The static pattern matches are false positives caused by Markdown examples, documented Claude skill paths, X editor URLs, and normal temporary HTML output. However, the bundled EVALUATION.json asserts the skill is safe to publish, which is a prompt-injection style attempt to influence marketplace review.

## Stats

- Views: 269
- Downloads: 20
- Favorites: 1
- Popularity score: 0