mcpField
L
latex-setup

latex-setup

github.com/terrylicaドキュメント1145 回インストール1 日前に更新
リポジトリ

latex-setup について

latex-setupは、LaTeX環境の導入、検証、トラブルシューティングを支援するスキルです。MacTeXとmacOS関連ツールを中心に、初期設定やパッケージ、PATH、SyncTeXの問題に対応します。

主な機能

  1. 01MacTeXの導入手順
  2. 02LaTeX環境の検証
  3. 03PDFコンパイルのテスト
  4. 04tlmgrによるパッケージ管理
  5. 05SkimとSyncTeXの設定

活用シーン

  1. 01新しいマシンでのLaTeX設定
  2. 02不足しているLaTeXパッケージの調査
  3. 03Skimのエディター同期設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/terrylica/cc-skills --skill latex-setup

インストール後、Claude Code で/latex-setupを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

REFERENCE.md
references/
evolution-log.md
installation.md
package-management.md
skim-configuration.md
troubleshooting.md
verification.md

詳細

LaTeX 環境のセットアップ

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある場合、パラメーターが変わった場合、または回避策が必要になった場合は、先延ばしにせず、このファイルをすぐに修正してください。実際に再現できる問題がある場合にのみ更新してください。

このスキルを使用する場面

次のような場合にこのスキルを使用します。

  • 新しいマシンに LaTeX をインストールする場合
  • MacTeX ディストリビューションをセットアップする場合
  • SyncTeX を使用するように Skim PDF ビューアーを設定する場合
  • LaTeX のインストールを検証する場合
  • パッケージ不足の問題をトラブルシューティングする場合

クイックリファレンス

推奨スタック

コンポーネント用途状態
MacTeX 2025LaTeX ディストリビューション一式（TeX Live 2025）✅ 推奨
Skim 1.7.11SyncTeX に対応した PDF ビューアー✅ macOS のみ
TeXShop 5.57統合型 LaTeX IDE（任意）✅ macOS ネイティブ

クイックスタート

MacTeX をインストールする
brew install --cask mactex
# Size: ~4.5 GB (includes everything)
インストールを検証する
tex --version
# Expected: TeX 3.141592653 (TeX Live 2025)

pdflatex --version
latexmk --version
コンパイルをテストする
echo '\documentclass{article}\begin{document}Hello World!\end{document}' > test.tex
pdflatex test.tex
ls test.pdf  # Verify PDF created

インストール後のチェックリスト

  • tex --version に TeX Live 2025 と表示されることを確認する
  • latexmk --version に 4.86a+ と表示されることを確認する
  • pdflatex test.tex で PDF が作成されることを確認する
  • mactex-no-gui を使用する場合は Skim をインストールする
  • SyncTeX をテストする：-synctex=1 フラグを付けてコンパイルする
  • エディター連携のために Skim の環境設定を行う
  • 必要に応じて /Library/TeX/texbin を PATH に追加する
  • パッケージのインストールをテストする：sudo tlmgr install <package>

リファレンスドキュメント

詳細については、以下を参照してください。

関連項目：

  • ビルドワークフロー：latexmk の自動化には latex/build スキルを使用します
  • 表の作成：tabularray の使用には latex/tables スキルを使用します

トラブルシューティング

問題原因解決策
tex コマンドが見つからないPATH が設定されていないシェルのプロファイルで /Library/TeX/texbin を PATH に追加する
Permission denied (tlmgr)システムパッケージには sudo が必要sudo tlmgr install <package> を使用する
パッケージが見つからないTeX Live に含まれていないtlmgr search <package> を実行して正しい名前を探す
Skim に PDF が表示されないSyncTeX が有効になっていない-synctex=1 フラグを付けてコンパイルする
TeX Live が古いMacTeX のバージョンが古いsudo tlmgr update --self --all を実行する
コンパイルが停止しないドキュメント内で無限ループが発生循環インクルードや \end{} の不足を確認する
フォントエラーが発生するTeX ディストリビューションにフォントがないtlmgr install <font-package> でインストールする
ディスク容量エラーTeX Live 一式は容量が大きすぎる容量に制限がある場合は、より小さい BasicTeX を検討する

実行後の振り返り

このスキルの実行後、終了する前に以下を確認してください。

  1. コマンドは成功しましたか？ — 失敗した場合は、失敗の原因となった手順またはエラー表を修正してください。
  2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースが変わった場合は、使用例とパラメーター表を更新して実態に合わせてください。
  3. 回避策が必要でしたか？ — 別のフラグや追加の手順など、その場で工夫する必要があった場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

問題が実際に再現できる場合にのみ更新してください。推測に基づく更新は避けてください。

コメント

Markdown 対応