ワンクリックでManusで任意のスキルを実行

readable-md

スター0

フォーク0

更新日2026年6月16日 12:44

Markdown を「人が読みやすく、かつ機械が HTML/スライドへ変換しやすい」構造に執筆・整形する。新規に調査/設計 md を書くときや、既存 md を昇華 (md→HTML→slide) の前に整えるときに使う。「読みやすい md にして」「昇華しやすく整形して」「調査 md を書いて」で起動。

インストール

Codex または Claude でインストールこの Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。

Manusで実行

ソース

linnefromice

linnefromice/ai-research-lab

GitHub リポジトリを開く Creator のリポジトリを見る

ダウンロード

Manusで実行

readable-md スキル

md→HTML→slide パイプラインの Stage 1。「読みやすい md = 機械が変換しやすい md」という等式に基づき、md を人にとって読みやすく・後段の変換 (HTML/スライド) が壊れない構造に揃える。

基本原則

読みやすい md は、そのまま TOC 自動生成・スライド分割・アクセシビリティを成立させる。 人向けの可読性ルールと、機械向けの変換しやすさは同じもの。

md = Source of Truth (正)。HTML / slide / PDF は再生成可能な派生物。内容修正は常に md 側。
構造を規則的・予測可能に保つ。例外的なレイアウトは後段の変換を壊す。
体裁ではなく構造を直す。色やフォントは後段 (テーマ asset) の仕事。

いつ使うか

状況	動作
`<topic>` を渡された (パスでない)	テンプレ (`templates/research-skeleton.md`) を骨子に新規執筆
既存 `<path>.md` を渡された	構造を解析し、原則に沿って整形リファクタ (内容は保つ)
`--check-only`	執筆/整形せず、`scripts/check-readable-md.sh` の結果だけ報告

実行手順

1. 入力の判別

引数がファイルパス → 既存 md の整形モード。まず Read する。
引数がトピック文字列 → 新規執筆モード。templates/research-skeleton.md を骨子に使う。
引数なし → 対象をユーザーに確認。

2. 構造原則の適用

執筆/整形時に次の 12 原則を満たす (起点レポート §A-1):

#	原則	対応ルール
1	H1 は 1 文書に 1 つ (タイトル)	MD025
2	見出しを飛ばさない (H2→H4 禁止)	MD001
3	ATX 見出し (`#`) を使う	MD003
4	1 セクション 1 主題 / 1 スライド 1 メッセージ	—
5	箇条書きは 3〜5 項目・1 項目 15 語以内 (目安)	—
6	コードフェンスに言語指定 (```lang)	MD040
7	要素を適材適所 (§A-2)	—
8	frontmatter で title/date/tags を構造化	—
9	画像に alt、リンクは意味のある語に	MD045/MD042
10	1 文 1 行 or 段落空行区切り (git diff が読みやすい)	—
11	markdownlint で機械強制	—
12	規則的・予測可能なパターン (= 機械可読性)	—

要素の使い分け (§A-2)

内容の性質	使う要素
並列・列挙	箇条書き `-`
手順・順序あり	番号付き `1.`
属性 × 対象の比較	表 `\|`
連続した説明・論理	段落
コマンド・コード	フェンスドコードブロック (言語指定)
注意・補足・引用	`>` blockquote
構造図・フロー	コードブロック内 ASCII or Mermaid

3. frontmatter を必ず付ける

---
title: "<タイトル>"
date: 2026-06-13
tags: [research]
---

title / date は後段の変換 (HTML の <title>、slide のヘッダ) が流用する。

4. 機械検証 (drift gate)

整形後、必ず構造チェッカを通す:

./scripts/check-readable-md.sh <path>.md
# markdownlint も併せて掛けるなら (npx 取得あり):
./scripts/check-readable-md.sh --lint <path>.md

error が出たら直してから完了とする。チェッカは次を機械検証する: H1 単一 / 見出し非スキップ / コードフェンス言語指定 / frontmatter title・date / 未閉鎖フェンス / インライン style= (warn)。

5. 完了報告

readable-md で整形しました:
  対象: <path>.md
  チェック: ✓ error 0 / warn N
  次段: /md-to-html <path>.md でHTML化、または Marp で slide 化

チェックリスト (§F-4 「昇華しやすい md か」)

frontmatter に title/date/tags があるか
H1 1 つ・見出しを飛ばしていないか
セクションが 1 主題で、そのままスライド 1 枚に要約できる粒度か
コードフェンスに言語指定があるか
図は Mermaid か ASCII (CJK 崩れに注意) で再生成可能か
テーマ/CSS が本文でなく後段の asset 側にあるか
check-readable-md.sh (+ markdownlint) が通るか
派生物 (html/slide/pdf) を手編集していないか (md 側でのみ修正)

注意事項

内容を勝手に足さない: 整形モードでは構造だけ直す。事実・主張の追加は別途確認。
体裁を md に書かない: 色/フォント/余白は後段テーマの仕事。style= 等を md に持ち込まない。
「3〜5 / 15 語」は目安: 経験則のガイドライン (blog 由来)。厳密な制約ではない。
由来: 親リポ ai-research-pipeline の deep-research レポート readable-markdown-to-html-slide-presentation-2026 の §A / §F を実装。

このリポジトリの他の Skills

同じリポジトリ

md-to-html

linnefromice/ai-research-lab

Markdown を共通テーマの HTML（画面ダーク / 印刷は A4 ライトテーマ）に変換する。「HTML 化して」「HTML 版を作って」「PDF にしたい」で起動。調査/設計/レポート md の配布・印刷用途に。素早く出すなら scripts/render-html.sh、リッチな card/box レイアウトが要るときは LLM 整形。

2026-06-160

md-to-slide

linnefromice/ai-research-lab

調査/レポート md を発表スライド (Marp) に昇華する。report.md を要約・分割して slides.md を作り、HTML/PDF/PPTX に書き出す。「スライドにして」「発表資料を作って」「Marp で」で起動。文書とスライドは編集距離があるため別ファイル (slides.md) として作る。

2026-06-160

design-review

linnefromice/ai-research-lab

生成した HTML / スライドが「見た目 human friendly」か、ノンデザイナーズ・デザインブックの C.R.A.P. (Contrast/Repetition/Alignment/Proximity) + タイポグラフィで品質レビューする。「デザインを見て」「読みやすい見た目か」「レイアウトをレビュー」で起動。機械監査 (design-audit.sh) を先に走らせ、静的に測れない整列・近接・視覚的印象を補う。

2026-06-160

breakdown-design

linnefromice/ai-research-lab

[2] design を実装単位に分解し、複数の [3] impl issue を起票する ([2]→[3] のブレイクダウン)。[2] を review + needs-human に遷移する。

2026-05-250

breakdown-request

linnefromice/ai-research-lab

[1] request を入力に [2] design issue を起票する ([1]→[2] のブレイクダウン)。元の [1] は close する。

2026-05-250

claim-issue

linnefromice/ai-research-lab

status:ready の issue を claim する。遷移直前に ready を再確認してから in-progress へ atomic 遷移し、二重取得のレース窓を最小化する。issue を処理開始する直前に必ず使う。

2026-05-250

name	readable-md
description	Markdown を「人が読みやすく、かつ機械が HTML/スライドへ変換しやすい」構造に執筆・整形する。新規に調査/設計 md を書くときや、既存 md を昇華 (md→HTML→slide) の前に整えるときに使う。「読みやすい md にして」「昇華しやすく整形して」「調査 md を書いて」で起動。
user_invocable	true
argument_hint	<target-md-path \| topic> [--check-only]
origin	ai-research-pipeline/deep-research/readable-markdown-to-html-slide-presentation-2026

readable-md スキル

基本原則

読みやすい md は、そのまま TOC 自動生成・スライド分割・アクセシビリティを成立させる。 人向けの可読性ルールと、機械向けの変換しやすさは同じもの。

md = Source of Truth (正)。HTML / slide / PDF は再生成可能な派生物。内容修正は常に md 側。
構造を規則的・予測可能に保つ。例外的なレイアウトは後段の変換を壊す。
体裁ではなく構造を直す。色やフォントは後段 (テーマ asset) の仕事。

いつ使うか

状況	動作
`<topic>` を渡された (パスでない)	テンプレ (`templates/research-skeleton.md`) を骨子に新規執筆
既存 `<path>.md` を渡された	構造を解析し、原則に沿って整形リファクタ (内容は保つ)
`--check-only`	執筆/整形せず、`scripts/check-readable-md.sh` の結果だけ報告

実行手順

1. 入力の判別

引数がファイルパス → 既存 md の整形モード。まず Read する。
引数がトピック文字列 → 新規執筆モード。templates/research-skeleton.md を骨子に使う。
引数なし → 対象をユーザーに確認。

2. 構造原則の適用

執筆/整形時に次の 12 原則を満たす (起点レポート §A-1):

#	原則	対応ルール
1	H1 は 1 文書に 1 つ (タイトル)	MD025
2	見出しを飛ばさない (H2→H4 禁止)	MD001
3	ATX 見出し (`#`) を使う	MD003
4	1 セクション 1 主題 / 1 スライド 1 メッセージ	—
5	箇条書きは 3〜5 項目・1 項目 15 語以内 (目安)	—
6	コードフェンスに言語指定 (```lang)	MD040
7	要素を適材適所 (§A-2)	—
8	frontmatter で title/date/tags を構造化	—
9	画像に alt、リンクは意味のある語に	MD045/MD042
10	1 文 1 行 or 段落空行区切り (git diff が読みやすい)	—
11	markdownlint で機械強制	—
12	規則的・予測可能なパターン (= 機械可読性)	—

要素の使い分け (§A-2)

内容の性質	使う要素
並列・列挙	箇条書き `-`
手順・順序あり	番号付き `1.`
属性 × 対象の比較	表 `\|`
連続した説明・論理	段落
コマンド・コード	フェンスドコードブロック (言語指定)
注意・補足・引用	`>` blockquote
構造図・フロー	コードブロック内 ASCII or Mermaid

3. frontmatter を必ず付ける

---
title: "<タイトル>"
date: 2026-06-13
tags: [research]
---

title / date は後段の変換 (HTML の <title>、slide のヘッダ) が流用する。

4. 機械検証 (drift gate)

整形後、必ず構造チェッカを通す:

./scripts/check-readable-md.sh <path>.md
# markdownlint も併せて掛けるなら (npx 取得あり):
./scripts/check-readable-md.sh --lint <path>.md

5. 完了報告

readable-md で整形しました:
  対象: <path>.md
  チェック: ✓ error 0 / warn N
  次段: /md-to-html <path>.md でHTML化、または Marp で slide 化

チェックリスト (§F-4 「昇華しやすい md か」)

frontmatter に title/date/tags があるか
H1 1 つ・見出しを飛ばしていないか
セクションが 1 主題で、そのままスライド 1 枚に要約できる粒度か
コードフェンスに言語指定があるか
図は Mermaid か ASCII (CJK 崩れに注意) で再生成可能か
テーマ/CSS が本文でなく後段の asset 側にあるか
check-readable-md.sh (+ markdownlint) が通るか
派生物 (html/slide/pdf) を手編集していないか (md 側でのみ修正)

注意事項

内容を勝手に足さない: 整形モードでは構造だけ直す。事実・主張の追加は別途確認。
体裁を md に書かない: 色/フォント/余白は後段テーマの仕事。style= 等を md に持ち込まない。
「3〜5 / 15 語」は目安: 経験則のガイドライン (blog 由来)。厳密な制約ではない。
由来: 親リポ ai-research-pipeline の deep-research レポート readable-markdown-to-html-slide-presentation-2026 の §A / §F を実装。