tellcheck

tellcheck

文章の文体を照合し、文章が機械生成のように読める原因となる特徴を検出します。すべてローカルで決定論的に動作します。ネットワーク接続、API キー、モデル呼び出しは不要です。状態（スタイル、辞書、指示、デフォルトスタイル）は、TELLCHECK_HOME または ~/.tellcheck 配下に JSON として保存されます。

これは、公開されている README のツール仕様をもとに、etincel のライティングスタイルツールをクリーンルーム方式で再構築したものです。スキーマは、その説明文から再構成して文書化しています。

できること

• スタイル。 12 種類のプリセット（Direct & Warm、Executive Brief、Reflective Essayist、Founder Memo、Plainspoken Analyst、Wry & Candid、PR Review、Code Comment、Slack Message、LinkedIn Post、Website Copy、Blog Post）が用意されています。それぞれに、フォーマルさ／温かさ／率直さのダイヤルと、リズムの説明があります。サンプルから独自のスタイルを学習したり、ダイヤルから直接作成したり、複製、更新、削除したり、デフォルトに設定したりできます。
• 文体の一致度。 文の長さとばらつき、短縮形の使用率、em ダッシュの使用、断片文、疑問文など、文章のリズムやメカニクスをスタイルのベースラインと比較します。入力が短い場合は、精度を装ったスコアではなく、信頼度が低いことを率直に示します。
• 自己反復。 文頭やフレーズの繰り返しを検出します。学習済みスタイルのサンプル内での繰り返しも対象です。
• AI らしさの監査。 決定論的に検出します。検出項目ごとに置き換え候補を提示する、組み込みの特徴語彙（例：「comprehensive」、「cutting-edge」、「leverage」、「seamless」、「streamline」）、リズムに関する検出結果（段落の長さが均一、リズムの変化が少ない）、長所（具体性、具体と抽象のバランス）が含まれます。緑、黄、オレンジ、赤のいずれかの段階と、0～100 のスコア、位置情報付きの検出結果を返します。レジスターは email、blog、memo、essay、social、docs、general、personal です。docs レジスターでは、Markdown 構造に関する検出結果が抑制されます。sourceFacts を指定すると、事実で裏付けられていない文章中の数値を検出します。
• 辞書と指示。 全体およびスタイルごとに、禁止語リストとカスタム単語リストを設定できるほか、自由形式のスタイル指示も設定できます。
• second_read は正直に。 元の実装では、ローカルインストールでの second_read は常に、明確な説明とともに失敗します。この機能にはホスト型モデルが必要だからです。この再構築版では、結果を偽装せず、その動作を正確に再現します。

CLI

各サブコマンドは各ツールに対応し、JSON 引数オブジェクトを 1 つ受け取ります。

npx @reneturcios/tellcheck list_styles '{}'
npx @reneturcios/tellcheck get_style_guide '{"styleId":"founder-memo"}'
npx @reneturcios/tellcheck train_style '{"name":"My Voice","samples":["..."]}'
npx @reneturcios/tellcheck audit_text '{"text":"...","register":"blog"}'
npx @reneturcios/tellcheck --version

終了コード：0 は成功、1 はツールエラー、2 は使用方法のエラーです。

MCP

npx -y @reneturcios/tellcheck mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "tellcheck": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tellcheck", "mcp"]
    }
  }
}

ツール（20）

ツール	用途
list_styles	プリセット、学習済みスタイル、および定義されている場合はチームスタイルを一覧表示します
get_style_guide	1 つのスタイルの完全なガイドを取得します
train_style	サンプルからスタイルを学習します（リズム、短縮形、em ダッシュ、段落のばらつき）
create_style_from_dials	11 個の文体ダイヤルからスタイルを作成します
update_style	スタイル名を変更するか、ダイヤルを調整します
fork_style	ローカルスタイルを複製します（公開ギャラリーのスタイルの複製は、正直にエラーを返します）
delete_style	ユーザー作成のスタイルを削除します
set_default_style	デフォルトスタイルを設定します
check_voice_match	スタイルのベースラインとリズム／メカニクスを比較します
check_self_repetition	学習サンプルとの照合も含め、文頭やフレーズの繰り返しを検出します
audit_text	段階、スコア、位置情報付きの検出結果を含む、決定論的な AI らしさの検出を行います
second_read	元の実装による明確な説明とともに、ローカルでは常に失敗します
add_banned_word / remove_banned_word	禁止語を管理します（全体またはスタイルごと）
add_custom_word / remove_custom_word	カスタム辞書の単語を管理します
list_dictionary	辞書の適用範囲と、スタイルに有効な統合リストを表示します
set_style_instructions / clear_style_instructions / get_style_instructions	自由形式のスタイル指示を管理します

Docker

docker run -i ghcr.io/cloudcorprecords/tellcheck          # stdio MCP server
docker run --rm ghcr.io/cloudcorprecords/tellcheck list_styles '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (temp TELLCHECK_HOME, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios