Proofreading Agent logo

Proofreading Agent

Community
minicoohei
proofreading-agent

日本語記事の校閲エージェント。誤字脱字、文法、表現の一貫性、読みやすさをチェックし、修正提案をインライン注釈で出力する。 「校閲して」「文章をチェック」「誤字脱字を確認」「記事をレビュー」等のリクエストで発動。

Overview

Publisherminicoohei
Repositoryai-agent-camp
Skill nameproofreading-agent
Stars
346
Forks
13
Bundled files
4
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 4 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by minicoohei on GitHub. Read the source before you install it.

Installation

Install the Proofreading Agent AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/minicoohei/ai-agent-camp/tree/main/.claude/skills/proofreading-agent
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/minicoohei/ai-agent-camp.git /tmp/ai-agent-camp
mkdir -p .claude/skills
cp -r /tmp/ai-agent-camp/.claude/skills/proofreading-agent .claude/skills/proofreading-agent
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Proofreading Agent in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Proofreading Agent on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Proofreading Agent is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

トリガーワード

「校閲して」「文章チェック」「誤字脱字」「推敲」「校正」

Proofreading Agent - 日本語記事校閲エージェント

日本語記事を体系的に校閲するエージェントです。コピーエディティングの「Seven Sweeps」手法にインスパイアされ、日本語コンテンツに最適化した Five Sweeps で記事を多角的にレビューします。

Five Sweeps(5段階校閲)

校閲は以下の5段階で実施します。各スイープは独立して実行でき、特定のカテゴリに集中したレビューも可能です。

1. 正確性チェック(Accuracy)

文字レベルの誤りを検出します。

  • 誤字脱字: 漢字の変換ミス、タイプミス
  • 送り仮名の誤り: 「行なう」→「行う」、「落し穴」→「落とし穴」
  • 同音異義語の誤用: 「以外」と「意外」、「対象」と「対称」
  • 固有名詞の表記ミス: 製品名、人名、組織名の正確性

2. 文法チェック(Grammar)

文法的な正しさを検証します。

  • 主述のねじれ: 主語と述語の不一致
  • 助詞の誤用: 「は」と「が」、「に」と「へ」の使い分け
  • 敬語の統一: 尊敬語・謙譲語・丁寧語の混在
  • 係り受けの誤り: 修飾語と被修飾語の関係
  • 時制の不一致: 過去形と現在形の混在

3. 一貫性チェック(Consistency)

記事全体を通した表記の統一性を確認します。

  • 表記揺れ: 「サーバー」と「サーバ」、「ユーザー」と「ユーザ」
  • 語尾の統一: 「です・ます」調と「だ・である」調の混在
  • 数字表記: 全角と半角の混在、「3つ」と「三つ」
  • 記号の統一: 括弧の種類、句読点(、。と,.)
  • 略語の統一: 初出でのフルスペル表記

4. 読みやすさチェック(Readability)

文章の読みやすさを評価します。

  • 一文の長さ: 80文字を超える文の検出
  • 難読漢字: 一般読者に難しい漢字の使用
  • 冗長表現: 「することができる」→「できる」
  • 二重否定: 「ないわけではない」→「ある」
  • 受身形の多用: 能動態への書き換え提案
  • カタカナ語の乱用: 日本語で十分伝わる箇所の指摘

5. 構成チェック(Structure)

記事全体の構成と論理展開を確認します。

  • 段落の論理的つながり: 前後の段落間の接続
  • 重複内容: 同じ情報の不要な繰り返し
  • 情報の過不足: 説明不足の箇所、不要な情報
  • 見出しの階層: 見出しレベルの適切さ
  • 導入と結論の整合性: 冒頭の問題提起と結論の対応

Usage

bash
# 全スイープで校閲(デフォルト)
python scripts/proofreading_agent.py --input article.md --output review.md

# 特定のスイープのみ実行
python scripts/proofreading_agent.py --input article.md --sweep accuracy
python scripts/proofreading_agent.py --input article.md --sweep grammar
python scripts/proofreading_agent.py --input article.md --sweep consistency
python scripts/proofreading_agent.py --input article.md --sweep readability
python scripts/proofreading_agent.py --input article.md --sweep structure

# スタイルプロファイルを指定
python scripts/proofreading_agent.py --input article.md --style style_profile.yaml

# 重要度フィルタ(high のみ表示)
python scripts/proofreading_agent.py --input article.md --severity high

# テストモード(API不要、サンプルテキストで動作確認)
python scripts/proofreading_agent.py --test

Parameters

ParameterRequiredDefaultDescription
--inputYes*-校閲対象のファイルパス(Markdown/テキスト)。--test 時は不要
--outputNooutput/review_{timestamp}.md校閲結果の出力先
--sweepNoall実行するスイープ: all, accuracy, grammar, consistency, readability, structure
--styleNo-スタイルプロファイル(YAML)のパス
--severityNomedium表示する最低重要度: low, medium, high
--testNofalseテストモード(サンプルテキストで API 不要の動作確認)

スタイルプロファイル(YAML)

記事の種類に応じたルールをカスタマイズできます。

yaml
# style_profile.yaml の例
name: "技術ブログ"
tone: "です・ます"
terminology:
  preferred:
    - { term: "サーバー", reject: ["サーバ"] }
    - { term: "ユーザー", reject: ["ユーザ"] }
    - { term: "インターフェース", reject: ["インタフェース", "インターフェイス"] }
  domain_terms:
    - "API"
    - "SDK"
    - "CI/CD"
rules:
  max_sentence_length: 80
  number_style: "半角"
  punctuation: "、。"

Output Format

インライン注釈

原文中の該当箇所に直接注釈を挿入します。

markdown
これはサーバ[校閲: 「サーバ」→「サーバー」(理由: 表記揺れ。記事内で「サーバー」が主要表記)]で動作する
アプリケーションです。データを保存することができます[校閲: 「保存することができます」→「保存できます」(理由: 冗長表現)]。

サマリーレポート

校閲結果の末尾に統計情報を出力します。

markdown
---
## 校閲サマリー

### 検出件数
| カテゴリ | 件数 |
|---------|------|
| 正確性(誤字脱字) | 3 |
| 文法 | 2 |
| 一貫性(表記揺れ) | 5 |
| 読みやすさ | 4 |
| 構成 | 1 |
| **合計** | **15** |

### 読みやすさスコア: 72/100
- 平均文長: 42文字(適切)
- 難読漢字率: 3%(やや高い)
- 冗長表現: 4箇所

### 重要度別
| 重要度 | 件数 |
|--------|------|
| HIGH | 3 |
| MEDIUM | 8 |
| LOW | 4 |

### 最重要修正 Top 5
1. [HIGH] L12: 「以外」→「意外」(同音異義語の誤用)
2. [HIGH] L34: 主語と述語が一致していない
3. [HIGH] L56: 「サーバ」と「サーバー」の表記揺れ(計5箇所)
4. [MEDIUM] L23: 一文が120文字を超えている
5. [MEDIUM] L45: 「することができる」→「できる」

読みやすさスコア算出

読みやすさスコア(0-100)は以下の要素から算出します。

要素配点基準
平均文長30点40文字以下: 30点、60文字以下: 20点、80文字以下: 10点、それ以上: 0点
漢字含有率20点20-35%: 20点、35-45%: 15点、それ以外: 10点
冗長表現率20点0%: 20点、冗長表現の割合に応じて減点
段落の適切さ15点1段落あたり3-5文: 15点、それ以外: 減点
接続詞の適切さ15点段落間の接続が明確: 15点

Requirements

  • API キー: GEMINI_API_KEY または GOOGLE_API_KEY(環境変数または .env)
  • Python パッケージ: google-genai, pyyaml, python-dotenv

Related Skills

  • document-processor: PDF/PPTX/Excel の統合処理
  • pptx-analyzer: PowerPoint スライド構造解析
  • screenshot-analyzer: スクリーンショットから情報抽出

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Proofreading Agent AI skill do?

日本語記事の校閲エージェント。誤字脱字、文法、表現の一貫性、読みやすさをチェックし、修正提案をインライン注釈で出力する。 「校閲して」「文章をチェック」「誤字脱字を確認」「記事をレビュー」等のリクエストで発動。

Why use Proofreading Agent on TypingMind?

Because you install it once and use it with any model. Proofreading Agent is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Proofreading Agent in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/minicoohei/ai-agent-camp/tree/main/.claude/skills/proofreading-agent. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Proofreading Agent?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Proofreading Agent?

As many as you like. As long as a model supports skills, you can use Proofreading Agent with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Proofreading Agent AI skill free?

It is published on GitHub by minicoohei. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇