메뉴
Markdown を「人が読みやすく、かつ機械が HTML/スライドへ変換しやすい」構造に執筆・整形する。新規に調査/設計 md を書くときや、既存 md を昇華 (md→HTML→slide) の前に整えるときに使う。「読みやすい md にして」「昇華しやすく整形して」「調査 md を書いて」で起動。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/linnefromice/ai-research-lab --skill readable-md명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
SOC 직업 분류 기준
| 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 |
md→HTML→slide パイプラインの Stage 1。「読みやすい md = 機械が変換しやすい md」 という等式に基づき、md を人にとって読みやすく・後段の変換 (HTML/スライド) が 壊れない構造に揃える。
読みやすい md は、そのまま TOC 自動生成・スライド分割・アクセシビリティを成立させる。 人向けの可読性ルールと、機械向けの変換しやすさは同じもの。
| 状況 | 動作 |
|---|---|
<topic> を渡された (パスでない) | テンプレ (templates/research-skeleton.md) を骨子に新規執筆 |
既存 <path>.md を渡された | 構造を解析し、原則に沿って整形リファクタ (内容は保つ) |
--check-only | 執筆/整形せず、scripts/check-readable-md.sh の結果だけ報告 |
templates/research-skeleton.md を骨子に使う。執筆/整形時に次の 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 | 規則的・予測可能なパターン (= 機械可読性) | — |
| 内容の性質 | 使う要素 |
|---|---|
| 並列・列挙 | 箇条書き - |
| 手順・順序あり | 番号付き 1. |
| 属性 × 対象の比較 | 表 | |
| 連続した説明・論理 | 段落 |
| コマンド・コード | フェンスドコードブロック (言語指定) |
| 注意・補足・引用 | > blockquote |
| 構造図・フロー | コードブロック内 ASCII or Mermaid |
---
title: "<タイトル>"
date: 2026-06-13
tags: [research]
---
title / date は後段の変換 (HTML の <title>、slide のヘッダ) が流用する。
整形後、必ず構造チェッカを通す:
./scripts/check-readable-md.sh <path>.md
# markdownlint も併せて掛けるなら (npx 取得あり):
./scripts/check-readable-md.sh --lint <path>.md
error が出たら直してから完了とする。チェッカは次を機械検証する:
H1 単一 / 見出し非スキップ / コードフェンス言語指定 / frontmatter title・date /
未閉鎖フェンス / インライン style= (warn)。
readable-md で整形しました:
対象: <path>.md
チェック: ✓ error 0 / warn N
次段: /md-to-html <path>.md でHTML化、または Marp で slide 化
style= 等を md に持ち込まない。ai-research-pipeline の deep-research レポート
readable-markdown-to-html-slide-presentation-2026 の §A / §F を実装。