render-puzzle-docs
Acerca de
Esta habilidad renderiza el sitio de documentación Quarto de jigsawR para GitHub Pages, admitiendo compilaciones nuevas (caché borrada), compilaciones en caché (más rápidas) y renderizado de una sola página. Se utiliza para compilaciones completas del sitio después de cambios en el contenido, vistas previas de páginas individuales durante la edición iterativa, y para preparar documentación para lanzamientos o PRs. La habilidad puede usar un script de renderizado incluido o llamar a quarto.exe directamente desde WSL.
Instalación rápida
Claude Code
Recomendadonpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/render-puzzle-docsCopia y pega este comando en Claude Code para instalar esta habilidad
Documentación
name: render-puzzle-docs description: > jigsawRのQuartoドキュメントサイトをGitHub Pages用にレンダリングする。 フレッシュレンダリング（キャッシュクリア）、キャッシュレンダリング（高速）、 シングルページレンダリングをサポート。バンドルされたレンダースクリプトまたは WSLからの直接quarto.exe呼び出しを使用する。コンテンツ変更後のフルサイト ビルド、反復編集中のシングルページレンダリング、リリースやPR向けの ドキュメント準備、Quarto .qmdファイルのレンダーエラーデバッグに使用する。 license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: jigsawr complexity: basic language: R tags: jigsawr, quarto, documentation, github-pages, rendering locale: ja source_locale: en source_commit: 6f65f316 translator: claude-sonnet-4-6 translation_date: 2026-03-16
パズルドキュメントのレンダリング
jigsawRのQuartoドキュメントサイトをレンダリングする。
使用タイミング
- コンテンツ変更後のフルドキュメントサイトビルド
- 反復編集中のシングルページレンダリング
- リリースやPR向けのドキュメント準備
- Quarto .qmdファイルのレンダーエラーデバッグ
入力
- 必須: レンダリングモード（
fresh、cached、またはsingle） - 任意: 特定の.qmdファイルパス（シングルページモード用）
- 任意: ブラウザで結果を開くかどうか
手順
ステップ1: レンダリングモードの選択
| モード | コマンド | 所要時間 | 使用場面 |
|---|---|---|---|
| Fresh | bash inst/scripts/render_quarto.sh | 約5-7分 | コンテンツ変更、キャッシュが古い場合 |
| Cached | bash inst/scripts/render_quarto.sh --cached | 約1-2分 | 軽微な編集、キャッシュが有効な場合 |
| Single | 直接quarto.exe | 約30秒 | 1ページの反復作業 |
期待結果： 現在の状況に基づいてレンダリングモードが選択される：コンテンツ変更や古いキャッシュにはfresh、軽微な編集にはcached、1ページの反復にはsingle。
失敗時： キャッシュが古いかどうか不明な場合は、freshレンダリングをデフォルトにする。時間はかかるが正しい出力が保証される。
ステップ2: レンダリングの実行
フレッシュレンダリング（_freezeと_siteをクリアし、すべてのRコードを再実行）：
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh
キャッシュレンダリング（既存の_freezeファイルを使用）：
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached
シングルページ（1つの.qmdファイルを直接レンダリング）：
QUARTO_EXE="/mnt/c/Program Files/RStudio/resources/app/bin/quarto/bin/quarto.exe"
"$QUARTO_EXE" render quarto/getting-started.qmd
期待結果： レンダリングがエラーなく完了する。出力はquarto/_site/に格納される。
失敗時：
- .qmdチャンクのRコードエラーを確認する（
#| label:マーカーを探す） - pandocが
RSTUDIO_PANDOC環境変数経由で利用可能か確認する - キャッシュをクリアしてみる：
rm -rf quarto/_freeze quarto/_site - .qmdファイルで使用されるすべてのRパッケージがインストールされているか確認する
ステップ3: 出力の検証
ls -la /mnt/d/dev/p/jigsawR/quarto/_site/index.html
サイト構造を確認する：
quarto/_site/index.htmlが存在する- ナビゲーションリンクが正しく解決される
- 画像とSVGファイルが正しくレンダリングされる
期待結果： index.htmlが存在し空でない。ナビゲーションリンクが解決され、画像/SVGがブラウザで正しくレンダリングされる。
失敗時： index.htmlが見つからない場合、レンダリングがサイレントに失敗した可能性がある。詳細出力で再実行し、.qmdチャンクのRコードエラーを確認する。一部のページのみ欠落している場合、それらの.qmdファイルが_quarto.ymlにリストされているか確認する。
ステップ4: プレビュー（任意）
Windowsブラウザで開く：
cmd.exe /c start "" "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"
期待結果： ドキュメントサイトがWindowsのデフォルトブラウザで目視検査のために開く。
失敗時： WSLからcmd.exe /c startコマンドが失敗する場合、代わりにexplorer.exe "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"を試す。または、ブラウザでファイルに手動でナビゲートする。
バリデーション
-
quarto/_site/index.htmlが存在し空でない - コンソール出力にレンダーエラーがない
- すべてのRコードチャンクが正常に実行された（エラーメッセージを確認）
- ページ間のナビゲーションが機能する
- すべての.qmdファイルがコードチャンクにクリーンな出力のための
#| label:を持つ
よくある落とし穴
- 古いフリーズキャッシュ: Rコードが変更された場合、
_freezeファイルを再生成するためにfreshレンダリングを使用する - 不足しているRパッケージ: Quarto .qmdファイルがrenvにないパッケージを使用している場合がある。先にインストールする
- pandocが見つからない:
.RenvironにRSTUDIO_PANDOCが設定されているか確認する - 長いレンダリング時間: freshレンダリングは5-7分かかる（R実行を伴う14ページ）。反復中はcachedモードを使用する
- コードチャンクラベル: すべてのRコードチャンクにクリーンなレンダリングのための
#| label:が必要
関連スキル
generate-puzzle— ドキュメントで参照されるパズル出力を生成するrun-puzzle-tests— ドキュメント内のコード例が正しいことを確認するcreate-quarto-report— 一般的なQuartoドキュメント作成
Repositorio GitHub
Habilidades relacionadas
executing-plans
DiseñoUtilice la habilidad executing-plans cuando tenga un plan de implementación completo para ejecutar en lotes controlados con puntos de revisión. Esta habilidad carga y revisa críticamente el plan, luego ejecuta tareas en pequeños lotes (por defecto 3 tareas) mientras reporta el progreso entre cada lote para la revisión del arquitecto. Esto asegura una implementación sistemática con puntos de control de calidad integrados.
requesting-code-review
DiseñoEsta habilidad despacha un subagente revisor de código para analizar los cambios en el código frente a los requisitos antes de proceder. Debe usarse después de completar tareas, implementar funciones principales o antes de fusionar con la rama principal. La revisión ayuda a detectar problemas de forma temprana al comparar la implementación actual con el plan original.
connect-mcp-server
DiseñoEsta habilidad proporciona una guía integral para que los desarrolladores conecten servidores MCP a Claude Code mediante transportes HTTP, stdio o SSE. Cubre la instalación, configuración, autenticación y seguridad para integrar servicios externos como GitHub, Notion y APIs personalizadas. Úsala al configurar integraciones MCP, al configurar herramientas externas o al trabajar con el Protocolo de Contexto del Modelo de Claude.
web-cli-teleport
DiseñoEsta habilidad ayuda a los desarrolladores a elegir entre las interfaces web y CLI de Claude Code mediante el análisis de tareas, y luego permite la teletransportación fluida de sesiones entre estos entornos. Optimiza el flujo de trabajo gestionando el estado y el contexto de la sesión al cambiar entre web, CLI o móvil. Úsala para proyectos complejos que requieren diferentes herramientas en varias etapas.