SKILL·C871E7

render-puzzle-docs

pjt222
Updated 1 month ago
23 views
21
3
21
View on GitHub
Metaworddesign

About

This skill renders the jigsawR Quarto documentation site for GitHub Pages, supporting fresh, cached, or single-page renders. Use it after content changes, during iterative editing, or when preparing documentation for releases. It can utilize either bundled scripts or direct Quarto invocation via WSL.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/render-puzzle-docs

Copy and paste this command in Claude Code to install this skill

Documentation

渲拼文

渲 jigsawR Quarto 文站。

  • 容變後建全站
  • 漸編時渲一頁
  • 為發或 PR 備文
  • 除 Quarto .qmd 渲錯

  • :渲模(freshcachedsingle
  • :特 .qmd 路(單頁模)
  • :果開於瀏覽乎

一:擇渲模

ModeCommandDurationUse when
Freshbash inst/scripts/render_quarto.sh~5-7 minContent changed, cache stale
Cachedbash inst/scripts/render_quarto.sh --cached~1-2 minMinor edits, cache valid
SingleDirect quarto.exe~30sIterating on one page

得:渲模按況選:fresh 為容變或舊快取、cached 為微編、single 為迭一頁。

敗:未定快取舊乎→默 fresh。費時而保正出。

二:執渲

Fresh 渲(清 _freeze_site、重執諸 R 碼):

cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh

Cached 渲(用現 _freeze 檔):

cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached

單頁(直渲一 .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 包皆裝

三:驗出

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

四:預(可)

於 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: 為潔出

  • 舊 freeze 快取:R 碼變、用 fresh 渲重生 _freeze
  • 缺 R 包:Quarto .qmd 或用 renv 外包;先裝
  • Pandoc 不見:確 RSTUDIO_PANDOC 設於 .Renviron
  • 長渲時:Fresh 渲費 5-7 分(14 頁含 R 執);迭時用 cached 模
  • 碼塊標:諸 R 碼塊應有 #| label: 為潔渲

  • generate-puzzle — 生文中所引拼出
  • run-puzzle-tests — 確文中碼例正
  • create-quarto-report — 通 Quarto 文建

GitHub Repository

pjt222/agent-almanac
Path: i18n/wenyan-ultra/skills/render-puzzle-docs
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams
FAQ

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 Meta category, tagged word 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.

Related Skills

content-collections
Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill
polymarket
Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill
creating-opencode-plugins
Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill
sglang
Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill