Communityライティング&編集github.com

pinosong/md-to-x-article-skill

Markdown の長文コンテンツを洗練された X 記事の公開原稿に変換します。ユーザーが Markdown を X 記事用に変換、適応、フォーマット、最適化するよう依頼した場合に使用します。コピー可能なリッチテキスト HTML 版と編集済み Markdown 版の両方を生成します。

md-to-x-article-skill とは?

このスキルは、Markdown 形式で書かれた長文記事を、X(旧 Twitter)の記事エディタに直接貼り付けて公開できる状態に変換するためのものです。主な機能は、元の内容(事実、リンク、数値、主張)を正確に保持しつつ、モバイルでの可読性を高めるために段落を短くし、見出しや箇条書きを適切に配置した構造化された原稿を生成することです。HTML 版と Markdown 版の両方を出力し、ユーザーは HTML をブラウザで開いて全文コピーし、X 記事エディタに貼り付けるだけで公開できます。画像、動画、GIF、X ポストの埋め込み位置を保持するインサーションマーカーも出力に含まれるため、ユーザーは X エディタ上でネイティブにメディアを追加する手順を明確に把握できます。このスキルは、Claude Code, Cursor, Codex など、Markdown を扱える任意の AI エージェント環境で動作し、SKILL.md に基づいて一貫した変換ワークフローを実行します。

対応~Claude Code~Codex CLI~Cursor
npx skills add pinosong/md-to-x-article-skill

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

alt

ドキュメント

Markdown を X 記事に変換

提供された Markdown を、正確でモバイルで読みやすく、X 記事エディタに貼り付けやすい X 記事の下書きに変換します。

基本ルール

  • 著者の意図、事実の主張、数値、リンク、全体的な立場を保持します。
  • 実質的な内容を書き換えずに、構造と表現を改善します。
  • 平易で専門的な言葉を使用します。プロモーション的な誇張や不必要な専門用語は避けます。
  • X が Markdown の直接インポートをサポートしているとは主張しないでください。HTML はコピー可能なリッチテキストソースとして扱い、アップロード形式としては扱いません。
  • X 記事には画像、動画、GIF、埋め込み X ポスト、リンクを含めることができます。意味のあるメディアアイテムとその意図された位置はすべて保持します。
  • HTML をコピーすることで X にメディアがアップロードまたは埋め込まれると暗示しないでください。ユーザーには X 記事エディタでネイティブにメディアを追加するよう指示します。
  • 短い段落、明確な見出し、リスト、太字、引用、リンクを優先します。
  • 最終的な公開原稿では Markdown のテーブルを使用しないでください。テーブルの各行は、太字のラベルを付けた簡潔な箇条書きに変換します。
  • 明らかなプレースホルダー、空のセクション、繰り返しの区切り線、ドラフト作成時のメモは削除します。
  • 不確かな事実や壊れたリンクは、修正をでっち上げるのではなく、フラグを立てます。

ワークフロー

  1. 編集前にソース全体を読みます。

  2. タイトル、冒頭、セクションの階層、テーブル、リンク、プレースホルダー、終わり方、およびすべてのリッチメディアを特定します。

  3. ソース順にメディアインベントリを作成します。

    • 画像とスクリーンショット
    • チャートと図
    • 動画と GIF ファイルまたはリンク
    • 埋め込み用の X ポスト URL
    • キャプション、クレジット、ソースリンク、代替テキスト
  4. 記事の主題と価値を正確に伝える具体的なタイトルを作成します。

  5. その主題がなぜ重要かを説明する簡潔な冒頭を追加または洗練します。根拠のない主張は追加しないでください。

  6. 階層を正規化します。

    • 1 つの記事タイトルを使用します。
    • 主要なアイデアにはセクション見出しを使用します。
    • サブ見出しはナビゲーションを改善する場合にのみ使用します。
    • 誤った、または一貫性のない番号付けを修正します。
  7. モバイルの可読性を改善します。

    • 1 段落につき 1 つの主要なアイデアに保ちます。
    • 密度の高い箇所を分割します。
    • 並列項目や手順には箇条書きまたは番号付きリストを使用します。
    • 最も重要なフレーズのみを太字にします。
  8. テーブルは次のパターンを使用してリストに変換します。

    - **ラベル**: 説明

  9. 以下のルールを使用してリッチメディアを処理します。

  10. 引用は引用ブロックとして保持し、有効なソースリンクも保持します。

  11. 簡潔な要約で終わりを強化します。空の推奨事項やリソースセクションは削除します。

  12. 提供前に検証チェックリストを実行します。

リッチメディアルール

画像、スクリーンショット、チャート、図

  • 意味のある各画像を、最も近い関連段落に保持します。
  • 有用な代替テキストは保持します。image のような曖昧な代替テキストは、画像の内容がわかっている場合にのみ改善します。
  • キャプション、クレジット、ソースリンクは代替テキストとは別に保持します。
  • ファイルシステムへのアクセスが可能な場合は、ローカル画像ファイルが存在することを確認します。
  • リモート画像 URL は参照用に保持しますが、公開時のホットリンク画像に依存しないでください。
  • HTML プレビューでは、img、alt、およびオプションで figcaption を使用してアクセシブルな画像をレンダリングします。
  • Markdown 出力では、標準の画像構文を保持します。
  • ソースに適切な候補がある場合は、1 つの強力で関連性の高いヘッダー画像を推奨します。依頼がない限り、画像をでっち上げたり生成したりしないでください。

動画と GIF

  • 元の URL またはファイル参照とその意図された位置を保持します。

  • 両方の出力に明確な挿入マーカーを追加します。例:

    [X エディタで動画を挿入: 製品デモ — ソース: ./demo.mp4]

  • 動画や GIF を自動再生する HTML 埋め込みに変換しないでください。

  • X 記事エディタへのネイティブアップロードを推奨します。

X ポスト

  • x.com および twitter.com のステータス URL を検出します。
  • URL を保持し、X 記事エディタへのネイティブポスト埋め込み用にマークします。
  • ユーザーが要求しない限り、X ポストをサポートされていない iframe やコピーされたスクリーンショットに置き換えないでください。

欠落またはアクセスできないメディア

  • 欠落しているメディアを黙って削除しないでください。
  • 元のパスまたは URL を含む挿入マーカーを保持します。
  • 欠落、アクセス不可、またはサポートされていないアイテムを配信サマリーで報告します。

メディア密度

  • 説明、実演、または証拠を提供するためにメディアを使用します。
  • 明確な目的なしに複数の装飾的な画像を一緒に配置しないでください。
  • キャプションは簡潔にし、各ビジュアルがコンテキスト内で理解できるようにします。

必須の出力

ユーザーが別の形式を要求しない限り、現在のワークスペースに次の 2 つのファイルを作成します。

  • x-article-ready.md: レビューと将来の改訂のための、編集済みで読みやすい Markdown。
  • x-article-ready.html: ユーザーがブラウザで開いて X 記事エディタにコピーできる、クリーンなリッチテキストページ。

HTML バージョンは以下を満たす必要があります。

  • article、h1、h2、h3、p、strong、em、blockquote、ul、ol、li、a などのセマンティック要素を使用します。
  • 該当する場合は画像に figure、img、figcaption を使用します。
  • UTF-8 およびレスポンシブビューポートのメタデータを含めます。
  • ブラウザでの快適なレビューのために、シンプルなインライン CSS を使用します。
  • JavaScript、外部依存関係、トラッキング、およびコピー後に残らない装飾要素を避けます。
  • デスクトップとモバイルでクリーンに表示されます。
  • 動画、GIF、欠落メディア、およびネイティブ X ポスト埋め込みのための可視の挿入マーカーを表示します。

環境がファイルを作成できない場合は、洗練された下書きを直接返し、その制限について簡単に説明します。

検証チェックリスト

提供する前に、以下を確認します。

  • タイトルが 1 回だけ出現する。
  • 見出しレベルが一貫している。
  • プレースホルダーや空のセクションが残っていない。
  • Markdown テーブルや区切り線のみの行が残っていない。
  • リストが完全で正しい順序である。
  • 太字と斜体のマーカーがバランスよく配置されている。
  • リンクが保持され、不正な形式になっていない。
  • すべてのリッチメディアがメディアインベントリに含まれ、記事内の正しい位置にある。
  • 画像の代替テキスト、キャプション、クレジット、ソースリンクが利用可能な場合は保持されている。
  • ローカルメディアパスが存在するか、欠落アイテムが明確に報告されている。
  • ネイティブエディタでの操作が必要な場所に、動画、GIF、X ポストの挿入マーカーが存在する。
  • 引用が明確に区別されている。
  • 実質的な主張、数値、結論が誤って変更されていない。
  • 記事が空のセクションでフェードアウトするのではなく、意図的に終了している。
  • HTML が正常に開き、Markdown バージョンと同じ記事コンテンツが含まれている。

配信

以下の内容を簡潔に述べます。

  • どのファイルが作成されたか。
  • 主な構造変更。
  • HTML バージョンをブラウザで開き、X 記事エディタにコピーする必要があること。
  • X にネイティブにアップロードまたは埋め込む必要がある画像、動画、GIF、X ポスト。
  • まだ人間によるレビューが必要な、事実、リンク、またはフォーマットに関する問題。

本地实测补充(2026-10-17、DeepSeek 1017 文章转 X 实测)

  • 不要直接粘 Markdown 进 X 编辑器:实测 ![alt](路径) 原样显示为文本,X 不解析。正确流:打开 x-article-ready.html → 全选复制 → 粘进 X 文章编辑器,标题/加粗/列表以富文本带过去。
  • HTML 预览里的图片必须 base64 内嵌:相对路径引用在用户单开文件时必裂图。视频不内嵌,留虚线插入标记,用户在编辑器手动上传。
  • X 文章封面 1600×900(16:9),feed 预览裁得更紧,关键内容居中;跟微信封面(900×500,订阅列表缩略图)流量逻辑不同,要区分设计。中文标题照旧 PIL 精确排。
  • 发布需要 Premium 及以上订阅;X Articles 支持正文任意位置内嵌多个视频。

関連スキル