菜单
Sphinx の HTML テーマ(Furo・sphinx_rtd_theme・Shibuya)を導入・設定するスキル。ドキュメントのテーマ変更やダークモード・サイドバー等の外観カスタマイズを求められたときに使用する。sphinx-revealjs のスライドテーマは revealjs-config が担当。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Sphinx ドキュメントの MyST Markdown 執筆支援スキル(ディレクティブ・ロール・相互参照・数式・sphinx-design)。extensions に myst_parser があるプロジェクトで docs/ 配下の .md を編集・作成するときや、MyST 記法について質問されたときに使用する。
sphinx-revealjs のスライドを MyST で書くための記法ルール(見出しレベルによるスライド分割、list-table、2 カラムレイアウト等)。extensions に sphinx_revealjs があるプロジェクトで docs/ 配下の .md を編集・作成するときに使用する。汎用 MyST 記法は myst-authoring が担当。
sphinx-revealjs の conf.py 設定(プラグイン・コードハイライト・テーマ・スライド寸法・表の中央寄せ・Mermaid 統合)の知識を提供するスキル。sphinx-revealjs プロジェクトでスライドの見た目や挙動を変更・修正するときに使用する。conf.py 編集の実行は sphinx-config に委譲する。
sphinx-revealjs によるスライド専用プロジェクトを初期化するスキル。docs/ が未作成のプロジェクトで発表スライドの新規作成を求められたときに使用する。依存追加・MyST テンプレート生成・テーマ選定・Makefile 整備までを行う。
既存の reStructuredText 製 Sphinx ドキュメントを rst-to-myst で MyST Markdown へ移行するスキル。実質的な RST コンテンツを持つプロジェクトの移行を求められたときに使用する(sphinx-quickstart の雛形だけの場合は対象外)。変換結果を検証してから元ファイルを削除する。
Sphinx ドキュメント・スライドを Makefile 経由でビルドするスキル(HTML・latexpdfja・EPUB・linkcheck・livehtml・revealjs)。ドキュメントやスライドのビルド・プレビュー・開発サーバー起動・リンクチェックを求められたときに使用する。パッケージマネージャ検出とビルドエラーの解釈は本文参照。
| name | sphinx-theme |
| description | Sphinx の HTML テーマ(Furo・sphinx_rtd_theme・Shibuya)を導入・設定するスキル。ドキュメントのテーマ変更やダークモード・サイドバー等の外観カスタマイズを求められたときに使用する。sphinx-revealjs のスライドテーマは revealjs-config が担当。 |
| license | MIT |
| allowed-tools | Bash, WebFetch, Read, Edit |
検出優先順位 (該当した時点で確定):
| 優先 | 判定条件 | 採用 |
|---|---|---|
| 1 | uv.lock が存在 | uv |
| 2 | poetry.lock が存在 | poetry |
| 3 | Pipfile.lock が存在 | pipenv |
| 4 | .venv/ のみ存在 (lockfile なし) | plain venv |
| 5 | 上記すべて該当しない | ユーザー問い合わせ (推奨: uv) |
依存追加コマンド対応:
uv add <pkg> --group docspoetry add --group docs <pkg>pipenv install --dev <pkg>pyproject.toml 手動編集 + pip install -e ".[docs]"検出した PM のコマンドが PATH に無ければ例外送出 (フォールバック禁止)。
| テーマ | パッケージ | 公式ドキュメント |
|---|---|---|
| Furo | furo | https://pradyunsg.me/furo/ |
| Read the Docs | sphinx-rtd-theme | https://sphinx-rtd-theme.readthedocs.io/ |
| Shibuya | shibuya | https://shibuya.lepture.com/ |
検出した PM で対応コマンドを実行:
uv add <theme-pkg> --group docs
# poetry: poetry add --group docs <theme-pkg>
# pipenv: pipenv install --dev <theme-pkg>
# plain venv: pyproject.toml 編集 → pip install -e ".[docs]"
sphinx-config スキルに委譲して html_theme の値を更新する。conf.py の安全な編集 (バックアップ・明示的エラー伝播) は sphinx-config の責務。
WebFetch で公式ドキュメントから最新の html_theme_options 仕様を取得:
https://pradyunsg.me/furo/customisation/https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.htmlhttps://shibuya.lepture.com/customisation/ユーザー要求 (ダークモード、ロゴ位置等) に合致するオプションを抽出し、html_theme_options 反映を sphinx-config に委譲。
_static/ 配下、LLM 一般判断領域)revealjs_style_theme) — html_theme はスライド出力に影響しないため revealjs-config へ委譲sphinx-config (テーマ・オプションの conf.py 反映)