render-puzzle-docs
À propos
Cette compétence génère un site de documentation Quarto pour GitHub Pages, prenant en charge les constructions complètes, les constructions plus rapides en cache et les rendus de page unique. Elle est utile pour construire le site complet après des modifications de contenu, pour éditer itérativement des pages individuelles ou pour préparer la documentation pour les mises en production. Elle peut utiliser soit un script de rendu inclus, soit appeler directement `quarto.exe` via WSL.
Installation rapide
Claude Code
Recommandénpx 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-docsCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
name: render-puzzle-docs description: > Renderizar el sitio de documentacion Quarto de jigsawR para GitHub Pages. Soporta renderizados frescos (limpiando cache), renderizados en cache (mas rapidos) y renderizados de pagina unica. Usa el script de renderizado incluido o la invocacion directa de quarto.exe desde WSL. Usar al construir el sitio completo despues de cambios de contenido, renderizar una sola pagina durante edicion iterativa, preparar documentacion para un release o PR, o depurar errores de renderizado en archivos 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: es source_locale: en source_commit: 6f65f316 translator: claude-sonnet-4-6 translation_date: 2026-03-16
Renderizar Documentacion de Rompecabezas
Renderizar el sitio de documentacion Quarto de jigsawR.
Cuando Usar
- Construir el sitio de documentacion completo despues de cambios de contenido
- Renderizar una sola pagina durante edicion iterativa
- Preparar documentacion para un release o PR
- Depurar errores de renderizado en archivos Quarto .qmd
Entradas
- Requerido: Modo de renderizado (
fresh,cachedosingle) - Opcional: Ruta especifica del archivo .qmd (para modo de pagina unica)
- Opcional: Si abrir el resultado en un navegador
Procedimiento
Paso 1: Elegir Modo de Renderizado
| Modo | Comando | Duracion | Usar cuando |
|---|---|---|---|
| Fresh | bash inst/scripts/render_quarto.sh | ~5-7 min | Contenido cambio, cache obsoleto |
| Cached | bash inst/scripts/render_quarto.sh --cached | ~1-2 min | Ediciones menores, cache valido |
| Single | quarto.exe directo | ~30s | Iterando en una pagina |
Esperado: Modo de renderizado seleccionado segun la situacion actual: fresh para cambios de contenido o cache obsoleto, cached para ediciones menores, single para iterar en una pagina.
En caso de fallo: Si no esta seguro de si el cache esta obsoleto, usar renderizado fresh por defecto. Toma mas tiempo pero garantiza salida correcta.
Paso 2: Ejecutar Renderizado
Renderizado fresh (limpia _freeze y _site, re-ejecuta todo el codigo R):
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh
Renderizado cached (usa archivos _freeze existentes):
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached
Pagina unica (renderizar un archivo .qmd directamente):
QUARTO_EXE="/mnt/c/Program Files/RStudio/resources/app/bin/quarto/bin/quarto.exe"
"$QUARTO_EXE" render quarto/getting-started.qmd
Esperado: El renderizado se completa sin errores. Salida en quarto/_site/.
En caso de fallo:
- Verificar errores de codigo R en chunks .qmd (buscar marcadores
#| label:) - Verificar que pandoc esta disponible via la variable de entorno
RSTUDIO_PANDOC - Intentar limpiar cache:
rm -rf quarto/_freeze quarto/_site - Verificar que todos los paquetes R usados en archivos .qmd estan instalados
Paso 3: Verificar Salida
ls -la /mnt/d/dev/p/jigsawR/quarto/_site/index.html
Confirmar la estructura del sitio:
quarto/_site/index.htmlexiste- Los enlaces de navegacion se resuelven correctamente
- Las imagenes y archivos SVG se renderizan correctamente
Esperado: index.html existe y no esta vacio. Los enlaces de navegacion se resuelven y las imagenes/SVGs se renderizan correctamente en el navegador.
En caso de fallo: Si index.html falta, el renderizado probablemente fallo silenciosamente. Re-ejecutar con salida detallada y verificar errores de codigo R en chunks .qmd. Si solo faltan algunas paginas, verificar que esos archivos .qmd estan listados en _quarto.yml.
Paso 4: Vista Previa (Opcional)
Abrir en el navegador de Windows:
cmd.exe /c start "" "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"
Esperado: El sitio de documentacion se abre en el navegador predeterminado de Windows para inspeccion visual.
En caso de fallo: Si el comando cmd.exe /c start falla desde WSL, intentar explorer.exe "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html" en su lugar. Alternativamente, navegar al archivo manualmente en el navegador.
Validacion
-
quarto/_site/index.htmlexiste y no esta vacio - Sin errores de renderizado en la salida de consola
- Todos los chunks de codigo R se ejecutaron exitosamente (verificar mensajes de error)
- La navegacion entre paginas funciona
- Todos los archivos .qmd tienen
#| label:en los chunks de codigo para salida limpia
Errores Comunes
- Cache freeze obsoleto: Si el codigo R cambio, usar renderizado fresh para regenerar archivos
_freeze - Paquetes R faltantes: Los archivos Quarto .qmd pueden usar paquetes que no estan en renv; instalarlos primero
- Pandoc no encontrado: Asegurar que
RSTUDIO_PANDOCesta configurado en.Renviron - Tiempos de renderizado largos: El renderizado fresh toma 5-7 minutos (14 paginas con ejecucion R); usar modo cached durante la iteracion
- Etiquetas de chunks de codigo: Todos los chunks de codigo R deben tener
#| label:para renderizado limpio
Habilidades Relacionadas
generate-puzzle-- generar salida de rompecabezas referenciada en la documentacionrun-puzzle-tests-- asegurar que los ejemplos de codigo en la documentacion son correctoscreate-quarto-report-- creacion general de documentos Quarto
Dépôt GitHub
Frequently asked questions
What is the render-puzzle-docs skill?
render-puzzle-docs is a Claude Skill by pjt222. Skills package instructions and resources that Claude loads on demand, so Claude can perform render-puzzle-docs-related tasks without extra prompting.
How do I install render-puzzle-docs?
Use the install commands on this page: add render-puzzle-docs to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.
What category does render-puzzle-docs belong to?
render-puzzle-docs is in the Design category, tagged word, api and design.
Is render-puzzle-docs free to use?
Yes. render-puzzle-docs is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.
Compétences associées
Utilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
Cette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
Cette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
Cette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.