MarkdownとMermaid執筆 スキル
Markdown文書とMermaid図を一緒に作ります。
コミュニティ · Clayton Young / K-Dense| 作者 | Clayton Young / K-Dense |
|---|---|
| ライセンス | Apache-2.0 (included skill content) |
| ソース | K-Dense-AI/scientific-agent-skills · GitHub 上の SKILL.md |
| 対応環境 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| ソースを確認した日 |
markdown-mermaid-writing: Markdown文書とMermaid図を一緒に作ります。
構造図と正確な定量グラフは役割が異なります。
スキルの SKILL.md より: # Markdown and Mermaid Writing
できること
- 文書と読み直せる図のソースを作成します。
得られるもの
- Markdown、Mermaid、任意のSVG/PNG/PDF。
使う場面
- 手順やシステムの関係を説明する場合。
向かない場面
- 統計グラフの代わりにMermaidを使う場合。
必要なもの
- テキスト編集環境。描画は任意でMermaid CLI 12、Node.js 22.13、Chromium。
スキルに含まれるファイル
| ファイル・フォルダー | 用途 |
|---|---|
SKILL.md | スキルの指示と作業手順。 |
2026-11-16 時点でリポジトリに記載されていたライセンス:Apache-2.0 (included skill content)。
プロンプト例
インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。
- MarkdownとMermaidで手順を説明して。
- シーケンス図の読みやすさを確認して。
- 図をSVGにレンダリングして。
markdown-mermaid-writing のインストール方法
実行環境の準備
文章だけならランタイム不要です。出力ツールは別途導入し、Apache-2.0表示を保持します。
スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:
Claude Code:スキルフォルダーにフォルダーをコピー
このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。
git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git
mkdir -p ~/.claude/skills
cp -R scientific-agent-skills/skills/markdown-mermaid-writing ~/.claude/skills/Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /markdown-mermaid-writing と入力するか、作業内容をそのまま伝えます。
Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。
Codex、Gemini CLI、Cursor、GitHub Copilot
これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:
git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git
mkdir -p .agents/skills
cp -R scientific-agent-skills/skills/markdown-mermaid-writing .agents/skills/| エージェント | プロジェクトのフォルダー | ユーザーのフォルダー | メモ |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
文章と図の管理
文書と図のソースを一緒に管理し、関係の変化を追跡します。
描画環境
構文、字体、配置は利用するレンダラーによって変わります。
markdown-mermaid-writing に関するよくある質問
スキルをコピーすると必要なツールも入りますか?
いいえ。実行ソフト、パッケージ、アカウント、外部サービスは別途設定します。
クラウドでの全工程は検証済みですか?
いいえ。ソースを確認したローカルエージェント向けの説明です。クラウドでの全工程は未検証です。
ソースがあれば描画も確認済みですか?
いいえ。使うレンダラーで出力を確認します。
全ファイルがMITですか?
いいえ。この収録スキルにはApache-2.0の帰属表示があります。
ほかの AI スキル
関連スキル
Matplotlib スキル
コミュニティ · K-DenseMatplotlibで科学図を作り、書き出しを確認します。Excalidraw CLI スキル
コミュニティ · swiftlysinghCLIで編集可能なExcalidraw図を生成します。戦略コンサル図解 スキル
コミュニティ · kgraph57戦略上の主張を根拠付きSVG・HTML図に整理します。D3 可視化 スキル
コミュニティ · chrisvoncsefalvay明示的なスケール、レスポンシブ寸法、後始末を備えた独自のD3グラフを作成します。Dashmotion スキル
コミュニティ · Mars (csthink)構造チェック付きの単独HTMLとして、動くフロー図や構成図を作ります。CSV データ要約 スキル
コミュニティ · coffeefuelbumpCSVの構造、欠損値、数値の要約をローカルPythonグラフで確認します。