Menu
概念・仕組み・調査内容を、HTML による視覚的な説明ドキュメントとして作成・編集する。
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Based on SOC occupation classification
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/mathbullet/skills --skill htmlThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Produce a detailed Markdown explainer of an academic paper. The skill aims for faithful description, not critical review. Section structure mirrors the original paper, equations render as LaTeX with variable tables, citations to the paper under review use position only, and citations to other works use author-short form. Use when the user asks for a detailed paper write-up, a thorough paper explainer, or invokes "paper details". Depends on documenting-with-sources and writing-quotation.
ユーザーとのあらゆるコミュニケーションの最初に、何かを書く・出力する前に必ず参照すること。チャット応答・レポート・解説・作業報告・ドキュメントなど、文章を書く・出力するすべての場面に適用される。
Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside). Defines mandatory citation, in-text reference format, quotation-versus-prose separation, the ban on fabricated associations, and the source-list format. Referenced by survey, paper-details, and any skill that produces sourced output.
| name | html |
| description | 概念・仕組み・調査内容を、HTML による視覚的な説明ドキュメントとして作成・編集する。 |
説明内容と日本語表現を補うため、次のスキルの併用を推奨する。
explain：概念や仕組みを説明するときの用語定義、説明の粒度、構成japanese-tech-writing：日本語の技術文書、記事、解説文の構成と文章規範cognitive-rhythm-writing：読み物としての緩急が必要な長文の文章規範いずれも推奨スキルであり、html の必須依存ではない。
{yyyymmdd}-{内容を表すケバブケース}.html とする。既存ファイルの更新では名前を変えない作成前に design-system/component-samples.html を確認する。コンポーネント集は design-system/document.css、数式コピー機能は design-system/math-copy.js を正とする。
既定では、成果物と一緒に必要なファイルを配置し、次の相対パスで読み込む。上位スキルが共有アセットのパスを指定した場合は、その指定を優先する。
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Ubuntu+Sans:wght@400;500;700&family=Noto+Sans+JP:wght@400;500;700&family=Ubuntu+Mono:wght@400;700&display=swap" rel="stylesheet">
<link rel="stylesheet" href="./design-system/document.css">
<script src="./design-system/math-copy.js"></script>
<script async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/highlight.min.js"></script>
<script>document.addEventListener("DOMContentLoaded", () => hljs.highlightAll());</script>
主要規則は次のとおり。
#FAF9F6。部品は白地、黒罫線、角丸を基本とする#2990DA とアクセント赤 #D63A2F に限定する.mb-quote を使い、原文と訳文を同じ文字サイズ・色で上下に並べる.mb-chip は並列の固有名や分類名の列挙にだけ使う.mb-rowlabel を付け、語中の折り返しを防ぐpre.mb-diff を使い、変更理由を散文で説明してから必要な断片を示す<style> は図の配置調整など最小限にとどめる説明対象に合わせて、並置、図解、タイムライン、要約、折りたたみを使い分ける。 一方向の単純な手順を、必要性なくフローチャートにしない。
基本構成は次の順とする。
h1 とリード文の後に .mb-toc の目次を置き、各 h2 に対応する id を付ける。
用語リストは .mb-wrap 内の aside.mb-glossary に置く。
専門用語は本文で使う前に 1〜2 文で定義する。
.mb-figure は、画像・SVGなどの視覚資料とキャプションを一つにまとめる外枠である。特定の図形や「矢印で結んだ箱」を意味しない.mb-figure-frame は視覚資料の表示面、figcaption は図番号・説明・出所の表示領域として使う.mb-figure-frame に載せるpre code には language-javascript、language-python、language-html などの言語クラスを必ず付けるlanguage-plaintext を付けるdocument.css の .hljs-* 規則を使うpre.mb-diff code には nohighlight を付け、差分専用の色と行頭記号を使う$...$、ディスプレイ数式は $$...$$ とする\boldsymbol{...} を使う\mathtt{...}、標準 LaTeX コマンドはそのまま使うmath-copy.js により、すべての数式から LaTeX 原文をコピーできるようにするwindow.MathJax を再定義しない印刷対応は document.css の @media print を使う。
PDF 化はユーザーから明示的に依頼された場合だけ render-pdf.sh を実行する。