Puzzletide crossword

Skill Caravaca-Labs/puzzletide-cli/skills/puzzletide-crossword

Word search generator, crossword generator, and sudoku generator & solver in one local-first CLI — printable PDF puzzle worksheets, themed word banks, verifiable LLM evals, and agent skills. From the makers of puzzletide.com.

Install

npx -y skills add Caravaca-Labs/puzzletide-cli --skill puzzletide-crossword

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

20 days oldThe repository was created 20 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use this skill whenever the user asks for a crossword puzzle — custom word/clue lists, themed crosswords, educational worksheets, or printable PDFs. Generates valid interlocking grids with standard numbering locally with the PuzzleTide CLI instead of hand-drawing grids.

SKILL.md

3.1 KB, as published. Nobody here has run it

PuzzleTide Crossword

Generate crossword puzzles with the local PuzzleTide CLI.

Never hand-draw a crossword grid. Language models cannot reliably keep intersecting words consistent. The CLI places words with real intersections, assigns standard crossword numbering, and validates that every clue's answer matches the grid before returning — words that cannot interlock are reported as unplaced instead of silently broken.

Prefer the local CLI. Check availability in this order:

ptide --version
puzzletide --version
npx puzzletide --version

If none of those work, ask the user before installing (npm install -g puzzletide).

Generate with your own clues (best quality)

Write the clues yourself — you are good at clues; the CLI is good at grids:

ptide crossword generate --words "PARIS: Capital of France; TOKYO: Capital of Japan; OSLO: Capital of Norway"

For longer lists use a JSON file:

ptide crossword generate --file words.json --pdf crossword.pdf
# words.json: [{"word": "PARIS", "clue": "Capital of France"}, ...]

Generate from a themed word bank

Clues are auto-generated puzzle-style hints (unscramble, letter counts):

ptide crossword generate --theme food/fruits --count 10

For better clues, pull the words and write clues yourself:

ptide words list food/fruits --count 10 --json
# ...then pass your own word:clue pairs to crossword generate.

Printable and structured output

ptide crossword generate --file words.json --pdf crossword.pdf --title "Science Review"
ptide run puzzle.crossword.generate --theme animals --json

The PDF has three sections: empty numbered grid, clue list, and solution. --json returns the grid ("#" = black cell) plus across/down clues with coordinates — ready for rendering in an app.

Safety

Puzzles are generated locally; no account, API key, or network access.
Do not install packages without asking the user first.