md-to-x-article-skill

Convert Markdown to X Article

Convert the supplied Markdown into an X Article draft that is accurate, readable on mobile, and easy to paste into the X Article editor.

Core Rules

• •Preserve the author's meaning, factual claims, numbers, links, and overall position.
• •Improve structure and presentation without silently rewriting substantive content.
• •Use plain, professional language. Avoid promotional exaggeration and unnecessary jargon.
• •Do not claim that X supports direct Markdown import. Treat HTML as a copy-ready rich-text source, not an upload format.
• •X Articles can contain images, video, GIFs, embedded X posts, and links. Preserve every meaningful media item and its intended position.
• •Do not imply that copying HTML will upload or embed media into X. Tell the user to add media natively in the X Article editor.
• •Prefer short paragraphs, clear headings, lists, bold emphasis, quotations, and links.
• •Do not use Markdown tables in the final publishing draft. Convert each table row into a concise bullet with a bold label.
• •Remove obvious placeholders, empty sections, repeated separators, and drafting notes.
• •Flag uncertain facts or broken links instead of inventing corrections.

Workflow

1. Read the complete source before editing.
2. Identify the title, opening, section hierarchy, tables, links, placeholders, ending, and all rich media.
3. Create a media inventory in source order:

- Images and screenshots - Charts and diagrams - Video and GIF files or links - X post URLs intended for embedding - Captions, credits, source links, and alt text

1. Create a specific title that accurately communicates the article's subject and value.
2. Add or refine a brief opening that explains why the subject matters. Do not add unsupported claims.
3. Normalize the hierarchy:

- Use one article title. - Use section headings for major ideas. - Use subheadings only where they improve navigation. - Fix incorrect or inconsistent numbering.

1. Improve mobile readability:

- Keep one main idea per paragraph. - Break up dense passages. - Use bullets or numbered lists for parallel items and procedures. - Bold only the most important phrases.

1. Convert tables to lists using this pattern:

- **Label**: explanation

1. Process rich media using the rules below.
2. Preserve quotations as blockquotes and preserve valid source links.
3. Strengthen the ending with a concise summary. Remove empty recommendation or resource sections.
4. Perform the validation checklist before delivery.

Rich Media Rules

Images, Screenshots, Charts, and Diagrams

• •Preserve each meaningful image at the closest relevant paragraph.
• •Preserve useful alt text. Improve vague alt text such as image only when the image content is known.
• •Preserve captions, credits, and source links separately from alt text.
• •Verify that local image files exist when filesystem access is available.
• •Keep remote image URLs for reference, but do not rely on hotlinked images for final publication.
• •In the HTML preview, render accessible images with img, alt, and optional figcaption.
• •In the Markdown output, preserve standard image syntax.
• •Recommend one strong, relevant header image when the source has a suitable candidate. Do not invent or generate one unless requested.

Video and GIFs

• •Preserve the original URL or file reference and its intended position.
• •Add a clear insertion marker in both outputs, such as:

[Insert video in X editor: product demonstration — source: ./demo.mp4]

• •Do not convert a video or GIF into an autoplaying HTML embed.
• •Recommend native upload in the X Article editor.

X Posts

• •Detect x.com and twitter.com status URLs.
• •Preserve the URL and mark it for native post embedding in the X Article editor.
• •Do not replace an X post with an unsupported iframe or copied screenshot unless the user requests it.

Missing or Inaccessible Media

• •Never silently remove missing media.
• •Keep an insertion marker that includes the original path or URL.
• •Report missing, inaccessible, or unsupported items in the delivery summary.

Media Density

• •Use media to explain, demonstrate, or provide evidence.
• •Avoid placing multiple decorative images together without a clear purpose.
• •Keep captions concise and ensure each visual is understandable in context.

Required Outputs

Unless the user requests another format, create both files in the current workspace:

• •x-article-ready.md: edited, readable Markdown for review and future revisions.
• •x-article-ready.html: a clean rich-text page that the user can open in a browser and copy into the X Article editor.

The HTML version must:

• •Use semantic elements such as article, h1, h2, h3, p, strong, em, blockquote, ul, ol, li, and a.
• •Use figure, img, and figcaption for images when applicable.
• •Include UTF-8 and responsive viewport metadata.
• •Use simple inline CSS for comfortable browser review.
• •Avoid JavaScript, external dependencies, tracking, and decorative elements that will not survive copying.
• •Display cleanly on desktop and mobile.
• •Show visible insertion markers for video, GIF, missing media, and native X post embeds.

If the environment cannot create files, return the polished draft directly and explain the limitation briefly.

Validation Checklist

Before delivering, verify:

• •The title appears once.
• •Heading levels are consistent.
• •No placeholders or empty sections remain.
• •No Markdown tables or separator-only lines remain.
• •Lists are complete and correctly ordered.
• •Bold and italic markers are balanced.
• •Links are preserved and not malformed.
• •All rich media appears in the media inventory and remains in the correct article position.
• •Image alt text, captions, credits, and source links are preserved where available.
• •Local media paths exist, or missing items are clearly reported.
• •Video, GIF, and X post insertion markers are present where native editor actions are required.
• •Quotes are clearly distinguished.
• •No substantive claim, number, or conclusion was accidentally changed.
• •The article ends deliberately rather than fading into an empty section.
• •The HTML opens successfully and contains the same article content as the Markdown version.

Delivery

Briefly state:

• •Which files were created.
• •The main structural changes made.
• •That the HTML version should be opened in a browser and copied into the X Article editor.
• •Which images, videos, GIFs, and X posts must be uploaded or embedded natively in X.
• •Any factual, link, or formatting issues that still require human review.