From agent-almanac
Generates jigsaw puzzle SVGs via generate_puzzle() or geom_puzzle_*() with parameter validation against config. Supports rectangular, hexagonal, concentric, voronoi, snic types. Use for puzzle creation, testing, or ggplot2 visualizations.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-almanac:generate-puzzleThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate jigsaw puzzles using the jigsawR package's unified API.
Generate jigsaw puzzles using the jigsawR package's unified API.
"rectangular", "hexagonal", "concentric", "voronoi", "random", "snic")c(cols, rows) or c(rings))"grid" or "repel" for rectangular)R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"
"$R_EXE" -e "cat(yaml::yaml.load_file('inst/config.yml')[['{TYPE}']]$grid$max)"
Or read inst/config.yml directly to check valid ranges for the chosen type.
Expected: The min/max values for grid, size, tabsize, and other parameters are known for the chosen puzzle type.
On failure: If config.yml is missing or the type key doesn't exist, check that you are in the jigsawR project root and the package has been built at least once.
Map the user's request to valid generate_puzzle() arguments:
| Type | grid | size | Extra params |
|---|---|---|---|
| rectangular | c(cols, rows) | c(width, height) mm | offset, layout, tabsize |
| hexagonal | c(rings) | c(diameter) mm | do_warp, do_trunc, tabsize |
| concentric | c(rings) | c(diameter) mm | center_shape, tabsize |
| voronoi | c(cols, rows) | c(width, height) mm | n_interior, tabsize |
| random | c(cols, rows) | c(width, height) mm | n_interior, tabsize |
| snic | c(cols, rows) | c(width, height) mm | n_interior, compactness, tabsize |
Expected: User request mapped to valid generate_puzzle() arguments with correct type, grid dimensions, and size values within the ranges from config.yml.
On failure: If unsure which parameter format to use, refer to the table above. Rectangular and voronoi types use c(cols, rows) for grid; hexagonal and concentric use c(rings).
Write a script file (preferred over -e for complex commands):
library(jigsawR)
result <- generate_puzzle(
type = "rectangular",
seed = 42,
grid = c(3, 4),
size = c(400, 300),
offset = 0,
layout = "grid"
)
cat("Pieces:", length(result$pieces), "\n")
cat("SVG length:", nchar(result$svg_content), "\n")
cat("Files:", paste(result$files, collapse = ", "), "\n")
Save to a temporary script file.
Expected: An R script file saved to a temporary location containing library(jigsawR), a generate_puzzle() call with all parameters, and diagnostic output lines.
On failure: If the script has syntax errors, verify that all string arguments are quoted and numeric vectors use c(). Avoid complex shell escaping by always using script files.
R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"
"$R_EXE" /path/to/script.R
Expected: Script completes without errors. SVG file(s) written to output/.
On failure: Check that renv is restored (renv::restore()). Verify package is loaded (devtools::load_all()). Do NOT use --vanilla flag (renv needs .Rprofile).
output/ directory<?xml or <svgExpected: SVG file exists in output/, content starts with <?xml or <svg, and piece count matches the grid specification (cols * rows for rectangular, ring formula for hex/concentric).
On failure: If SVG file is missing, check the output/ directory exists. If piece count is wrong, verify grid dimensions match the puzzle type's expected formula. For ggplot2 output, check that the plot renders without error by wrapping in tryCatch().
Generated files are saved to output/ by default. The result object contains:
$svg_content — raw SVG string$pieces — list of piece data$canvas_size — dimensions$files — paths to written filesExpected: The result object contains $svg_content, $pieces, $canvas_size, and $files fields. Files listed in $files exist on disk.
On failure: If $files is empty, the puzzle may have generated in-memory only. Explicitly save with writeLines(result$svg_content, "output/puzzle.svg").
--vanilla flag: Breaks renv activation. Never use it.-e commands: Use script files instead; shell escaping causes Exit code 5.snic package installed.add-puzzle-type — scaffold a new puzzle type end-to-endvalidate-piles-notation — validate fusion group strings before passing to generate_puzzle()run-puzzle-tests — run the test suite after generation changeswrite-testthat-tests — add tests for new generation scenariosnpx claudepluginhub pjt222/agent-almanacScaffolds a new puzzle type across all 10+ pipeline integration points in jigsawR, including core module, unified pipeline wiring, ggpuzzle layers, DESCRIPTION/config updates, Shiny app extension, and test suite.
Creates, edits, reviews, and validates high-quality SVG graphics with W3C compliance, CSS independence, accessibility, and safety.
Plans puzzle-based activities for classrooms, parties, team-building, and events, generating structured timelines, objectives, prep checklists, and one-click generator links for word searches, crosswords, sudokus, bingo, and jigsaws.