# Zenn Proofreader

> Zenn記事のMarkdown校正を行うスキル。記事を読み、Zenn独自記法の正確性・見出し構造・コードブロック・リンク・画像・テーブル・埋め込み・メッセージ/アコーディオン記法をチェックし、改善提案を行う。ユーザーが「Zenn記事を校正して」「Zennの記法をチェックして」「記事をレビューして」「Markdown確認して」と依頼した際に使用する。

- Skill: `majiayu000/zenn-proofreader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/zenn-proofreader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/zenn-proofreader/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/zenn-proofreader

---


# Zenn記事校正スキル

## 校正の流れ

1. 記事ファイル（.md）を読み込む
2. 以下のチェック項目を順番に確認
3. 問題点と改善提案をリストアップ
4. 必要に応じて修正を提案

## チェック項目

### 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](zenn-markdown-guide.md) を参照。

## 出力形式

校正結果は以下の形式で報告：

```
## 校正結果

### 問題点
- **行XX**: [カテゴリ] 問題の説明
  - 修正案: `修正後のコード`

### 改善提案
- 読みやすさ向上のための提案
- アクセシビリティ改善の提案

### 良い点
- 正しく使われている記法のハイライト
```