本文へ移動
cccskills
無料GitHub で公開

en-to-ja-explainer

英語の技術ドキュメント (Hugging Face docs / GitHub README / arXiv 論文 / 技術ブログ等) を、日本人が読んで AI 生成と気づかない自然な日本語の解説サイトに変換します。フェッチ → 構成 → HTML/CSS/JS 生成 → 多角レビュー → 修正 → ローカル配信、まで一気通貫。

日本語自然さチェックは `@agent-naturalize-ja:naturalize-ja` subagent に委譲 (辞書本体・grep・質的レビューはそちら側に集約)。技術正確性は codex-cli、UX/レスポンシブは汎用 Agent が担当。

Triggers: 「英語ドキュメントを日本語で解説するサイトを作って」「Japanese explainer for [URL]」「英語の技術ドキュメントをやさしく日本語にして」「Convert this English doc to a Japanese site」「AI っぽくない日本語で技術解説」「Hugging Face docs を日本語化」「arXiv を日本語で噛み砕いて」「en-to-ja explainer」「/en-to-ja-explainer」

連携ツールGitHubHugging Face

実行スコア 未検証

インストール方法を見る

含まれるファイル(5)

  • SKILL.md11.2 KB
  • references/site-template-guide.md7.2 KB
  • references/team-roles.md6.3 KB
  • references/tech-translation-guide.md5.4 KB
  • scripts/serve.sh1.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

en-to-ja-explainer

英語の技術ドキュメントを、日本人が読んで AI 生成と分からない自然な日本語の解説サイトに変換するスキル。最大の差別化は「AI っぽい日本語の自動除去」。

いつ使うか

  • 英語のドキュメント (URL or 貼り付けテキスト) から日本語解説サイトを作ってほしいと言われたとき
  • 既存の日本語サイトを「AI 臭を抜きたい」と言われたとき
  • ユーザーが特定フレーズを「これ AI っぽい」と指摘し、似たパターンを全体に展開してほしいとき

逆に使わないケース:

  • 数行レベルの短い翻訳 (skill を介さず直接対応)
  • 解説を伴わない素の翻訳のみ (翻訳特化のスキルがあればそちら)

入力で確認すること

ユーザーが指定していなければ、最大 2 つだけ聞く:

  1. ソース URL または貼り付けテキスト
  2. 想定読者層 (初学者 / 中級 / 上級) — 足場づくりの深さに影響
  3. 出力ディレクトリ — デフォルト ./<topic>-ja-explainer/
  4. ローカル配信ポート — デフォルト 8765

聞きすぎない。3 件以上は推測 + デフォルトで進めて、必要なら後で確認。

ワークフロー

Step 1: フェッチと構成設計

  1. WebFetch で英語の原文を取得。長すぎる場合はパスごとに分けて取得し、構成段階で取捨選択する
  2. 抽出する要素:
    • トピック名 / スコープ
    • 読者が知らない可能性のある専門用語
    • 前提知識 (上流概念)
    • 原文に出てくる主な例 / アナロジー (再利用すると一貫性が出る)
  3. 日本語のセクション構成案を作る。標準的な骨格:
    1. なぜこの記事を読むのか (intro + ゴール)
    2. 前提知識・用語の確認
    3. 中心概念を 3-7 セクションで段階的に
    4. 数式や仕様の読み解き
    5. インタラクティブな確認 (任意)
    6. コマンド / コードの読み方 (該当する場合)
    7. 用語集
  4. 構成案をユーザーに 1 度提示し、合意を取ってから本文を書き始める

Step 2: サイトの雛形を生成

最低限 3 ファイル:

<output-dir>/
├── index.html       # 1 ページで完結
├── styles.css       # レスポンシブ前提
└── script.js        # 任意。インタラクティブな確認 UI 等

詳細な構造・breakpoint・SVG ルールは references/site-template-guide.md を参照。最低限守るべきこと:

  • clamp() で hero/h1/h2/h3/pre をビューポート連動に
  • SVG は min-width: 640px + overflow-x: auto (スマホでは横スクロール、ただし字が潰れない)
  • <table> / <pre> も overflow-x: auto
  • TOC はタブレット幅で 2 列、スマホで 1 列に切り替え
  • すべての <label> に for="..."、動的結果領域に aria-live="polite"

Step 3: 日本語本文を書く

各セクションで:

  1. 当たり前の日本語でドラフト
  2. ドラフト直後に @agent-naturalize-ja:naturalize-ja <file> --policy auto を呼んで、CRITICAL の AI 臭を除去
  3. 残った IMPORTANT は文脈を見て個別判断

「読みやすさ」ではなく「ネイティブが読んで引っかからないか」を最適化軸にする。 用語訳の一貫性と文体は references/tech-translation-guide.md を参照。AI 臭のカテゴリ辞書 (A-O) と grep は naturalize-ja:naturalize-ja subagent 側に集約されているため、このスキルは詳細を抱えない。

Step 4: 多角レビュー

references/team-roles.md の各レビューを並列で走らせる:

  • 技術正確性レビュー — codex-cli スキルにデリゲート。英語原文と日本語の対応を機械的にクロスチェック
  • 日本語自然さレビュー — @agent-naturalize-ja:naturalize-ja subagent にデリゲート (--policy propose で findings を回収し、Step 5 の Synthesis に統合)
  • UX/レスポンシブレビュー — 汎用 Agent。SVG overflow、表のはみ出し、コードブロック、clamp() の使用などを静的に検証
  • (任意) 学習体験レビュー — 汎用 Agent。読者層に対して説明順序が妥当か

依存関係がないので可能な限り並列。プロンプト・委譲先のテンプレートは references/team-roles.md にある。

Step 5: 修正の適用

references/team-roles.md の Synthesis Protocol に従う:

  • CRITICAL → 自動適用
  • IMPORTANT → ユーザーに確認 (内容変更や文体に影響するため)
  • NICE-TO-HAVE → 提示のみ、適用は明示の指示が来てから

適用後、もう一度 patterns ファイルの grep を回し、新規 AI 臭が混入していないか確認する。

Step 6: ローカル配信

scripts/serve.sh <output-dir> [port] で起動 (内部で python3 -m http.server)。

LAN IP も解決して、スマホからアクセスできる URL も併せて返す。

Step 7: ユーザーへの最終報告

返す内容:

  • ローカル URL
  • LAN URL (取れた場合のみ)
  • 生成ファイルのパス一覧
  • 適用したレビュー findings の要約 (CRITICAL は何件、IMPORTANT は何件保留中、など)
  • 残課題・既知の制約

References

  • references/team-roles.md — レビューの並列実行プロトコルと委譲先 (日本語自然さは naturalize-ja:naturalize-ja subagent へ)
  • references/site-template-guide.md — HTML / CSS / SVG / レスポンシブの基本パターンと落とし穴
  • references/tech-translation-guide.md — 英→日の用語訳と文体方針

委譲する外部サブエージェント / スキル

  • @agent-naturalize-ja:naturalize-ja (subagent) — 日本語の AI 臭検出と置換。 Step 3 (ドラフト直後の自動修正) と Step 4 (自然さレビュー) の両方で起動する。 辞書本体・grep・質的レビューは subagent 側に集約。
  • codex-cli (skill) — 技術正確性レビューで起動 (英↔日のクロスチェック)

Behavior Scenarios

Scenario: 英語 URL から日本語解説サイトを生成
  Given ユーザーが英語の技術ドキュメント URL を提示
  When ユーザーが「Hugging Face docs を日本語化して explainer サイト作って」と言う
  Then スキルは原文をフェッチし、構成案を提示して合意を取り、HTML/CSS/JS を
       レスポンシブで生成、AI 臭 grep + 多角レビューを実施、CRITICAL を適用、
       ローカルサーバを起動して URL を返す

Scenario: 既存サイトの日本語自然さ監査
  Given ユーザーが既に書かれた日本語の HTML ファイルを指定
  When ユーザーが「AI っぽい日本語をレビューして直して」と言う
  Then スキルは ai-japanese-patterns.md の grep を実行し、自然さレビュー
       エージェントを起動、カテゴリ別に Before/After を提示、承認分を適用

Scenario: ユーザーが 1 フレーズを「これ AI っぽい」と指摘
  Given サイトは既に生成済み
  When ユーザーが該当フレーズを引用して「これ AI っぽい」と指摘
  Then スキルは `@agent-naturalize-ja:naturalize-ja` subagent に該当フレーズと
       対象ファイルを渡し、一括検出・修正を委譲する。新パターンの辞書登録
       判断も subagent 側で行う

Scenario: モバイル / レスポンシブの不具合報告
  Given ユーザーが「文字が切れている」「表がはみ出る」等のレイアウト問題を報告
  When ユーザーがスクリーンショットまたは現象を共有
  Then スキルは SVG viewBox overflow / table overflow / フォントスケーリングの
       いずれかを特定し、site-template-guide.md の対応パターンに沿って
       最小差分の修正を適用する

Scenario: 長すぎる英語ソース
  Given 原文が長文 (arXiv 論文等)
  When ユーザーが日本語 explainer 作成を依頼
  Then スキルは複数パスで取得 (abstract → 主要セクション → 必要時の詳細) し、
       本文を書き始める前にセクション構成をユーザーに確認する

Scenario: ユーザーが想定読者層を未指定
  Given URL 以外の前提条件が指定されていない
  When スキルが起動
  Then 想定読者層・出力ディレクトリ・ポートの 3 つを最大 2 つだけ確認する。
       それ以上は推測 + デフォルトで進める

Retrospective

セッション完了時 (Step 7 が終わった後) に次を行う:

  1. セッション中の出来事を振り返る:
    • 構成案や訳語の差し戻し
    • レイアウト / SVG の修正
    • naturalize-ja のレビューで覆った AI 臭表現 (傾向のみ)
  2. ユーザーに 1 行で問いかける: 「今回のレビューで気になった構成・訳語・レイアウトがあれば一言だけ (Enter でスキップ)」
  3. ユーザーからフィードバックがある場合のみ: a. このスキルの feedback/log.md に追記 (git rev-parse --show-toplevel で解決) b. 日本語表現に関するフィードバックなら naturalize-ja 側の feedback/log.md への転記も提案する
  4. クリーンに完走でフィードバックが無ければ、ログは書かず終了

ログのフォーマットは references/skill-improvement-guide.md (factory 側) を参照。

Feedback Check

スキル起動時、feedback/log.md に 5 件以上あれば直近 10 件を読む。同じ問題 (構成案 / 訳語 / レイアウト系) が 3 件以上で出ていれば、ユーザーに伝える:

「直近のフィードバックで『X』というパターンが繰り返し検出されています。SKILL.md または references の見直しを提案します。」

決定はユーザーに委ね、深い分析が必要なら /skill-improve --skill en-to-ja-explainer に進める。日本語表現関連の繰り返し問題は naturalize-ja 側の話なので、そちらに /skill-improve --skill naturalize-ja を案内する。

ログが無い、または 5 件未満なら静かにスキップ。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

Run a multi-model adversarial mutual review with facilitator synthesis: 2+ panelists (different model families where possible — use codex-server / codex-cli for the external-family seat) independently answer, adversarially critique each other across rounds, and the main session acts as facilitator, synthesizing agreements, live disagreements, and calibrated confidence into one answer. Use ONLY on high-stakes, hard-to-reverse claims, designs or decisions, and only when the user EXPLICITLY asks to debate or adversarially review with multiple models — "discuss with Opus and Codex", "red-team this", "devil's advocate", 敵対的レビュー, 相互レビュー, 多モデル討論, 議論させて. A full run costs ~6 subagent/CLI dispatches: state the panel size and round count and get a go-ahead before launching. Where the Workflow tool is available, run the panel as a Workflow (judge-panel / adversarial-verify) instead of ad-hoc fan-out. Do NOT self-trigger on a bare "are you sure?" — that is a cue to OFFER the panel, not to run it.

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Orchestrate multiple coding-agent sessions (Claude Code, Codex, Gemini) over the mcp_agent_mail MCP server, observe their progress on a recurring auto-loop, and prevent inconsistencies (file/edit conflicts and contradictory decisions) between concurrent tasks. Auto-manages the agent-mail server, derives the shared room key from the git repo, and runs either as the orchestrator/observer or as a participating worker. Handles the operational details (server startup, room key, reservation conventions) so the user does not have to remember them. Use when coordinating several agent sessions on different tasks at once, watching a swarm of sessions for conflicts, or wiring already-running sessions into a shared coordination room. Trigger phrases: "agent-swarm", "/agent-swarm", "orchestrate agents", "orchestrate multiple claude sessions", "coordinate sessions", "watch for conflicts between agents", "observe the swarm", "prevent inconsistency between sessions", "multi-agent observe", "複数セッションを協調", "エージェント協調", "セッション間の不整合監視", "スウォーム監視", "複数のClaudeを束ねて".

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Generate AGENTS.md (cross-tool agent context — Codex CLI, Aider, Cursor, etc.) and wire CLAUDE.md as a symlink so Claude Code reads the same file. Delegates content generation to Claude's built-in /init when needed, then renames + symlinks. Idempotent. Triggers — /agents-init, "generate agents.md", "create agents.md", "share claude and codex context", "set up agents file", "init agents", "agents-init", "cross-tool agent context", "wire claude and agents".

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Drive an already-running, LOGGED-IN Chromium browser on macOS via AppleScript — navigate, click, fill forms, scroll, and extract page content from the user's REAL session, with the browser left open and NO profile copy and NO restart. Use when the task needs the existing logged-in session (cookies, auth, current tabs) reused as-is. Trigger phrases: "chrome-use", "ブラウザから取得", "ログイン済みの Chromeで", "ブラウザを操作して", "このページ読んで", "Xのスレッド読んで", "ログインしたまま取得", "自分のセッションでスクレイプ", "read this page in my browser", "scrape with my session", "drive my chrome", "execute JS in my (logged-in) browser", "automate my logged-in browser". Chromium family (Chrome default; Brave/Edge/Arc/Vivaldi via --app). NOT for isolated/throwaway automation where login reuse is unneeded — use playwright-cli for that. macOS only.

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

codex-cli

無料

Run OpenAI Codex CLI from the terminal for batch / one-shot `codex exec` invocations with output captured to an `-o` file. Use for fire-and-forget runs, scripted CI, code review batches (`codex review`), and resuming a specific session by id (`codex exec resume`). Always use this skill instead of `mcp__codex__codex` and `mcp__codex__codex-reply` MCP tools — CLI is faster and more capable. For streaming UX, multi-turn dialogues that need live state, structured (JSON schema) output, attaching images, or programmatic event handling → **use codex-server instead**. codex-server uses the user's ChatGPT subscription via Codex App Server and decoupled async invocation that bypasses the Bash 2-minute timeout entirely. Trigger patterns (batch-only — chat/streaming triggers belong to codex-server): codex-cli / codex CLI / codex exec / codex review / codex resume / codex fork / batch + {codex, gpt} / one-shot + {codex, gpt} / non-interactive + codex / codex {to a file, -o, output file, captured output} / CI + {codex, gpt} / scripted + {codex, gpt} / fork codex session / resume codex session by id

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Run OpenAI Codex via the Codex App Server (JSON-RPC-over-stdio) for streaming multi-turn chat sessions with persistent threads, structured output, image input, and rich event streams. Default entry point for ChatGPT/GPT/Codex-like conversations from the terminal. Uses the user's ChatGPT subscription (Plus / Pro / Team) exclusively via `codex login` — never consumes OPENAI_API_KEY billing, by design. Implementation: TypeScript on deno with npm:@openai/codex-sdk; spawns the existing system codex binary. Decoupled async invocation: every turn returns turn-id in <1 s; the actual SDK work runs in a detached worker that streams to per-turn files under ~/.codex-server/turns/<turn-id>/ — Bash's 2-min timeout never applies. Prefer this over codex-cli for streaming UX, multi-turn dialogues that need live state, structured (JSON schema) output, attaching images, or programmatic event handling. Use codex-cli only for one-shot batch invocations that pre-capture to an -o file. For OpenAI Platform API calls specifically (embeddings, image generation, audio, moderation, batches, files) — not open-ended chat — use openai-cli instead; that path bills OPENAI_API_KEY, this one uses the ChatGPT subscription. Trigger patterns (match any variation): codex / codex-server / codex app server / codex app-server / openai / open ai / OpenAI / chatgpt / chat gpt / ChatGPT / GPT / ask gpt / chat with gpt / gpt session / codex session / streaming chat / multi-turn chat / multi turn chat / second opinion / cross-check / cross check / ai pair programming / another AI / external AI / ask another model / get GPT's take / what does openai think / show me what gpt thinks / structured output from gpt / json schema gpt / resume codex thread / continue codex conversation / continue codex session / /codex-server

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

hideki5123 のスキルをすべて見る

このスキルの問題を報告する