Run Puzzle Tests

Run jigsawR test suite via WSL R. Supports full suite, filtered by pattern, or single file. Interprets pass/fail/skip counts and identifies failing tests. Never use `--vanilla` (renv needs `.Rprofile` to activate). Use after R source changes, after adding a puzzle type or feature, before commits, or when debugging a specific failure.

45 stars 4 forksTesting & QA

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add pjt222/agent-almanac --skill run-puzzle-tests
Manual install
git clone --depth 1 https://github.com/pjt222/agent-almanac.git /tmp/agent-almanac
mkdir -p ~/.claude/skills
cp -r /tmp/agent-almanac/i18n/caveman-lite/skills/run-puzzle-tests ~/.claude/skills/run-puzzle-tests

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Run Puzzle Tests

Run the jigsawR test suite and interpret results.

## When to Use

- After modifying R source code in the package
- After adding a new puzzle type or feature
- Before committing changes
- Debugging a specific test failure

## Inputs

- **Required**: Test scope (`full`, `filtered`, or `single`)
- **Optional**: Filter pattern for filtered mode (e.g. `"snic"`, `"rectangular"`)
- **Optional**: Specific test file path for single mode

## Procedure

### Step 1: Choose Test Scope

| Scope | Use when | Duration |
|---|---|---|
| Full | Before commits, after major changes | ~2-5 min |
| Filtered | Working on one puzzle type | ~30s |
| Single | Debugging a specific test file | ~10s |

**Got:** Test scope selected: full before commits, filtered for one puzzle type, single for debugging one test.

**If fail:** If unsure, default to full suite. Slower but catches cross-type regressions.

### Step 2: Create and Execute Test Script

**Full suite**:

Create a script (e.g., `/tmp/run_tests.R`):

```r
devtools::test()
```

```bash
R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"
cd /mnt/d/dev/p/jigsawR && "$R_EXE" -e "devtools::test()"
```

**Filtered by pattern**:

```bash
"$R_EXE" -e "devtools::test(filter = 'snic')"
```

**Single file**:

```bash
"$R_EXE" -e "testthat::test_file('tests/testthat/test-snic-puzzles.R')"
```

**Got:** Test output with pass/fail/skip counts.

**If fail:**
- Do NOT use `--vanilla`; renv needs `.Rprofile` to activate
Read the full skill on GitHub

Details

Skill name
run-puzzle-tests
Path
i18n/caveman-lite/skills/run-puzzle-tests/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Run Puzzle Tests skill do?

Run jigsawR test suite via WSL R. Supports full suite, filtered by pattern, or single file. Interprets pass/fail/skip counts and identifies failing tests. Never use `--vanilla` (renv needs `.Rprofile` to activate). Use after R source changes, after adding a puzzle type or feature, before commits, or when debugging a specific failure.

How do I install the Run Puzzle Tests skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add pjt222/agent-almanac --skill run-puzzle-tests. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Run Puzzle Tests popular?

It lives in pjt222/agent-almanac, which has 45 GitHub stars and 4 forks, and is included in 1 curated skill list.

Related skills

Adapt Architecture

45

pjt222/agent-almanac

Execute structural metamorphosis using strangler fig migration, chrysalis phases, and interface preservation. Covers transformation planning, parallel running, progressive cutover, rollback design, and post-metamorphosis stabilization for system architecture evolution. Use when assess-form has classified the system as READY for transformation, when migrating from monolith to microservices, when replacing a core subsystem while dependents continue operating, or when any architectural change must be gradual rather than big-bang.

Software DevelopmentIn 1 list

Adaptic

45

pjt222/agent-almanac

Master skill composing the 5-step synoptic cycle for panoramic synthesis across multiple domains. Orchestrates meditate, expand-awareness, observe, awareness, integrate-gestalt, and express-insight into a coherent process that produces unified understanding rather than sequential compromise. Use when a problem genuinely spans 3+ domains and the interactions between domains matter more than depth in any one, when sequential analysis feels like compromise rather than integration, or before major architectural decisions affecting multiple stakeholders.

OtherIn 1 list

Add Puzzle Type

45

pjt222/agent-almanac

Scaffold a new puzzle type across all 10+ pipeline integration points in jigsawR. Creates the core puzzle module, wires it into the unified pipeline (generation, positioning, rendering, adjacency), adds ggpuzzle geom/stat layers, updates DESCRIPTION and config.yml, extends the Shiny app, and creates a comprehensive test suite. Use when adding a completely new puzzle type to the package or following the 10-point integration checklist to ensure nothing is missed end-to-end.

Testing & QAIn 1 list

Sharpen Knife

45

pjt222/agent-almanac

Sharpen and maintain knives using whetstones, field stones, and improvised abrasives. Covers blade anatomy, bevel assessment, whetstone technique (coarse to fine progression), stropping, sharpness testing, field sharpening methods, and ongoing edge maintenance. Use when a knife fails the fingernail test, when cutting tasks require excessive pressure, before a trip where a sharp blade is essential, after heavy use, or when a blade has visible nicks or a rolled edge. Applicable to bushcraft blades, folding knives, and garden cutting tools.

Testing & QAIn 1 list

Run Chaos Experiment

45

pjt222/agent-almanac

Design and run chaos experiments using Litmus or Chaos Mesh. Test system resilience via controlled fault injection, validate hypothesis-driven tests, improve failure recovery. Use before major launches, after architecture changes, during GameDays or DR drills, to validate failure mode assumptions, or as part of an SRE maturity program.

Testing & QAIn 1 list

TDD Workflow

41

wolverin0/claude-skills

Guide test-first implementation for features, bug fixes, and refactors. Use when the user wants tests to drive or protect code changes.

Testing & QA

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.