zenn-proofreader
Zenn 文章的 Markdown 校对技能。阅读文章,检查 Zenn 独特语法的准确性、标题结构、代码块、链接、图像、表格、嵌入和消息/手风琴语法,并提出改进建议。当用户要求"校对 Zenn 文章"、"检查 Zenn 语法"、"审查文章"或"确认 Markdown"时使用。
📖 中文导读:Zenn 文章的 Markdown 校对技能。阅读文章,检查 Zenn 独特语法的准确性、标题结构、代码块、链接、图像、表格、嵌入和消息/手风琴语法,并提出改进建议。当用户要求"校对 Zenn 文章"、"检查 Zenn 语法"、"审查文章"或"确认 Markdown"时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: zenn-proofreader description: Zenn記事のMarkdown校正を行うスキル。記事を読み、Zenn独自記法の正確性・見出し構造・コードブロック・リンク・画像・テーブル・埋め込み・メッセージ/アコーディオン記法をチェックし、改善提案を行う。ユーザーが「Zenn記事を校正して」「Zennの記法をチェックして」「記事をレビューして」「Markdown確認して」と依頼した際に使用する。
Zenn記事校正スキル
校正の流れ
- 記事ファイル(.md)を読み込む
- 以下のチェック項目を順番に確認
- 問題点と改善提案をリストアップ
- 必要に応じて修正を提案
チェック項目
1. 見出し構造
-
#(H1)を本文で使っていないか(タイトル専用) -
##から始めているか - 見出しレベルを飛ばしていないか(##→####は不可)
- 見出しの前に空行があるか
2. コードブロック
- 言語指定があるか
- ファイル名表示が正しい形式か(
言語:ファイル名) - diffの場合、
diff 言語形式になっているか - コードブロックが正しく閉じられているか
3. 画像
- alt属性が適切に設定されているか
- サイズ指定の形式が正しいか(
=250x) - キャプションを使う場合、画像直後に
*キャプション*形式か
4. Zenn独自記法
-
:::messageが:::で閉じられているか -
:::message alertの形式が正しいか -
:::details タイトルが:::で閉じられているか - 独自記法のネストが適切か
5. 埋め込み
- URLが単独行に配置されているか
- 対応サービス(YouTube, GitHub, Twitter等)のURLか
- GitHubの行番号指定が正しい形式か(
#L1-L10)
6. 数式
- ブロック数式は
$$で囲まれているか - インライン数式は
$で囲まれているか - KaTeX構文が正しいか
7. 一般的なMarkdown
- リンクの形式が正しいか(
[テキスト](URL)) - リストのインデントが統一されているか
- テーブルの形式が正しいか
- 注釈(
[^1]と[^1]:)が対応しているか
記法リファレンス
詳細な記法は zenn-markdown-guide.md を参照。
出力形式
校正結果は以下の形式で報告:
## 校正結果
### 問題点
- **行XX**: [カテゴリ] 問題の説明
- 修正案: `修正後のコード`
### 改善提案
- 読みやすさ向上のための提案
- アクセシビリティ改善の提案
### 良い点
- 正しく使われている記法のハイライト