pjt222/render-puzzle-docs
i18n/de/skills/render-puzzle-docs/SKILL.md
Die jigsawR Quarto-Dokumentationsseite fuer GitHub Pages rendern. Unterstuetzt frisches Rendern (Cache loeschen), gecachtes Rendern (schneller) und Einzelseiten-Rendern. Verwendet das mitgelieferte Render-Skript oder direkten quarto.exe-Aufruf aus WSL. Anwenden beim Erstellen der vollstaendigen Seite nach Inhaltsaenderungen, beim Rendern einer einzelnen Seite waehrend iterativer Bearbeitung, beim Vorbereiten der Dokumentation fuer ein Release oder PR, oder beim Debuggen von Renderfehlern in Quarto-.qmd-Dateien.
$ install --global
skillsauthnpx skillsauth add pjt222/agent-almanac render-puzzle-docsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 9:25 AM8.0s1 file scanned
SKILL.md
- name:
- render-puzzle-docs
- locale:
- de
- source_locale:
- en
- source_commit:
- 6f65f316
- translator:
- claude
- translation_date:
- 2026-03-17
- description:
- >
- license:
- MIT
- allowed-tools:
- Read Write Edit Bash Grep Glob
- author:
- Philipp Thoss
- version:
- 1.0
- domain:
- jigsawr
- complexity:
- basic
- language:
- R
- tags:
- jigsawr, quarto, documentation, github-pages, rendering
Puzzle-Dokumentation rendern
Die jigsawR Quarto-Dokumentationsseite rendern.
Wann verwenden
- Vollstaendige Dokumentationsseite nach Inhaltsaenderungen erstellen
- Einzelne Seite waehrend iterativer Bearbeitung rendern
- Dokumentation fuer ein Release oder PR vorbereiten
- Renderfehler in Quarto-.qmd-Dateien debuggen
Eingaben
- Erforderlich: Render-Modus (
fresh,cachedodersingle) - Optional: Spezifischer .qmd-Dateipfad (fuer Einzelseiten-Modus)
- Optional: Ob das Ergebnis im Browser geoeffnet werden soll
Vorgehensweise
Schritt 1: Render-Modus waehlen
| Modus | Befehl | Dauer | Verwendung |
|-------|--------|-------|------------|
| Frisch | bash inst/scripts/render_quarto.sh | ~5-7 Min | Inhalt geaendert, Cache veraltet |
| Gecacht | bash inst/scripts/render_quarto.sh --cached | ~1-2 Min | Kleine Aenderungen, Cache gueltig |
| Einzeln | Direkter quarto.exe-Aufruf | ~30s | Iteration an einer Seite |
Erwartet: Render-Modus basierend auf der aktuellen Situation ausgewaehlt: frisch fuer Inhaltsaenderungen oder veralteten Cache, gecacht fuer kleine Aenderungen, einzeln fuer Iteration an einer Seite.
Bei Fehler: Im Zweifelsfall ob der Cache veraltet ist, standardmaessig frisch rendern. Es dauert laenger, garantiert aber korrekte Ausgabe.
Schritt 2: Rendern ausfuehren
Frisches Rendern (loescht _freeze und _site, fuehrt allen R-Code erneut aus):
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh
Gecachtes Rendern (verwendet vorhandene _freeze-Dateien):
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached
Einzelne Seite (eine .qmd-Datei direkt rendern):
QUARTO_EXE="/mnt/c/Program Files/RStudio/resources/app/bin/quarto/bin/quarto.exe"
"$QUARTO_EXE" render quarto/getting-started.qmd
Erwartet: Rendern wird ohne Fehler abgeschlossen. Ausgabe in quarto/_site/.
Bei Fehler:
- Auf R-Code-Fehler in .qmd-Chunks pruefen (nach
#| label:-Markern suchen) - Sicherstellen dass pandoc ueber die Umgebungsvariable
RSTUDIO_PANDOCverfuegbar ist - Cache loeschen versuchen:
rm -rf quarto/_freeze quarto/_site - Pruefen ob alle in .qmd-Dateien verwendeten R-Pakete installiert sind
Schritt 3: Ausgabe ueberpruefen
ls -la /mnt/d/dev/p/jigsawR/quarto/_site/index.html
Die Seitenstruktur bestaetigen:
quarto/_site/index.htmlexistiert- Navigationslinks loesen korrekt auf
- Bilder und SVG-Dateien werden korrekt dargestellt
Erwartet: index.html existiert und ist nicht leer. Navigationslinks loesen auf, und Bilder/SVGs werden im Browser korrekt dargestellt.
Bei Fehler: Wenn index.html fehlt, ist das Rendern wahrscheinlich stillschweigend fehlgeschlagen. Mit ausfuehrlicher Ausgabe erneut ausfuehren und auf R-Code-Fehler in .qmd-Chunks pruefen. Wenn nur einige Seiten fehlen, ueberpruefen ob diese .qmd-Dateien in _quarto.yml aufgefuehrt sind.
Schritt 4: Vorschau (Optional)
Im Windows-Browser oeffnen:
cmd.exe /c start "" "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"
Erwartet: Die Dokumentationsseite oeffnet sich im Windows-Standardbrowser zur visuellen Pruefung.
Bei Fehler: Wenn der cmd.exe /c start-Befehl aus WSL fehlschlaegt, stattdessen explorer.exe "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html" versuchen. Alternativ die Datei manuell im Browser aufrufen.
Validierung
- [ ]
quarto/_site/index.htmlexistiert und ist nicht leer - [ ] Keine Renderfehler in der Konsolenausgabe
- [ ] Alle R-Code-Chunks wurden erfolgreich ausgefuehrt (auf Fehlermeldungen pruefen)
- [ ] Navigation zwischen Seiten funktioniert
- [ ] Alle .qmd-Dateien haben
#| label:bei Code-Chunks fuer saubere Ausgabe
Haeufige Stolperfallen
- Veralteter Freeze-Cache: Wenn sich R-Code geaendert hat, frisches Rendern zum Neugenerieren der
_freeze-Dateien verwenden - Fehlende R-Pakete: Quarto-.qmd-Dateien koennten Pakete nutzen die nicht in renv enthalten sind; diese zuerst installieren
- Pandoc nicht gefunden: Sicherstellen dass
RSTUDIO_PANDOCin.Renvirongesetzt ist - Lange Renderzeiten: Frisches Rendern dauert 5-7 Minuten (14 Seiten mit R-Ausfuehrung); gecachten Modus waehrend der Iteration verwenden
- Code-Chunk-Label: Alle R-Code-Chunks sollten
#| label:fuer sauberes Rendering haben
Verwandte Skills
generate-puzzle— Puzzle-Ausgabe generieren auf die in der Dokumentation verwiesen wirdrun-puzzle-tests— Sicherstellen dass Codebeispiele in der Doku korrekt sindcreate-quarto-report— Allgemeine Quarto-Dokumenterstellung
Related Skills
pjt222/unleash-the-agents
testing
VerifiedTrustedCommunity
Launch all available agents in parallel waves for open-ended hypothesis generation on problems where the correct domain is unknown. Use when facing a cross-domain problem with no clear starting point, when single-agent approaches have stalled, or when diverse perspectives are more valuable than deep expertise. Produces a ranked hypothesis set with convergence analysis and adversarial refinement.
9SKILL.mdUpdated Apr 15, 2026
pjt222/test-cli-application
tools
VerifiedTrustedCommunity
Write integration tests for a Node.js CLI application using the built-in node:test module. Covers the exec helper pattern, output assertions, filesystem state verification, cleanup hooks, JSON output parsing, error case testing, and state restoration after destructive tests. Use when adding tests to an existing CLI, testing a new command, verifying adapter behavior across frameworks, or setting up CI for a CLI tool.
9SKILL.mdUpdated Apr 15, 2026
pjt222/screen-trademark
development
VerifiedTrustedCommunity
Screen a proposed trademark for conflicts and distinctiveness before filing. Covers trademark database searches (TMview, WIPO Global Brand Database, USPTO TESS), distinctiveness analysis using the Abercrombie spectrum, likelihood of confusion assessment using DuPont factors and EUIPO relative grounds, common law rights evaluation, and goods/services overlap analysis. Produces a conflict report with a risk matrix. Use before adopting a new brand name, logo, or slogan — distinct from patent prior art search, which uses different databases, legal frameworks, and analysis methods.
9SKILL.mdUpdated Apr 15, 2026
pjt222/scaffold-cli-command
tools
VerifiedTrustedCommunity
Scaffold a new CLI command using Commander.js with options, action handler, three output modes (human-readable, quiet, JSON), and optional ceremony variant. Covers command naming, option design, shared context patterns, error handling, and integration testing. Use when adding a command to an existing Commander.js CLI, designing a new CLI tool from scratch, or standardizing command structure across a multi-command CLI.
9SKILL.mdUpdated Apr 15, 2026