The npm package bundles SKILL.md agent skills for Pi, Hermes, OpenClaw, and
other SKILL.md-based agent systems. Pi loads them straight from npm:
pi install npm:puzzletideThe package manifest declares:
{
"pi": {
"skills": ["./skills"]
}
}Each skill prefers the local CLI and checks ptide, puzzletide, then
npx puzzletide. Skills never auto-install dependencies; agents should ask
the user before installing anything.
Generate word search puzzles — themed or from custom word lists, terminal or printable PDF. The core instruction to agents: never hand-write a letter grid; the CLI guarantees every word is actually findable.
Generate crosswords with valid interlocking grids and standard numbering. Agents write the clues (they're good at that); the CLI builds the grid (it's good at that).
Generate sudoku with a unique-solution guarantee, solve any puzzle from its 81-character string, and validate user-provided grids for conflicts and uniqueness.
Print-ready PDF worksheets (puzzle + solution pages, letter or A4) for
classrooms, parties, and activity packets, including multi-sheet packets via
--seed.
Reproducible puzzle task sets with by-construction grading — sudoku answers are verified against the rules and givens, word search answers against the grid — for benchmarking models and agents without an LLM judge.
skills/
puzzletide-word-search/SKILL.md
puzzletide-crossword/SKILL.md
puzzletide-sudoku/SKILL.md
puzzletide-printable-puzzles/SKILL.md
puzzletide-agent-evals/SKILL.md
The frontmatter carries openclaw and hermes metadata (tags, required
binaries, install hints) alongside the standard name/description fields.