PuzzleTide Puzzle Generator

oficial

Generador de sopas de letras, crucigramas y sudokus como servidor MCP con hojas de trabajo imprimibles en PDF, bancos de palabras temáticos y evaluaciones verificables para LLM. Local-first, de los creadores de puzzletide.com.

GitHub

¿Qué puedes hacer con Puzzle Tide Puzzle Generator MCP?

Generar una sopa de letras — crear una cuadrícula de sopa de letras a partir de palabras personalizadas, un archivo o un tema incluido usando puzzle_wordsearch_generate.
Generar un crucigrama — producir un crucigrama entrelazado con numeración estándar y pistas validadas mediante puzzle_crossword_generate.
Generar o resolver un sudoku — crear un sudoku con una solución única garantizada (puzzle_sudoku_generate) o resolver una cadena de rompecabezas de 81 caracteres (puzzle_sudoku_solve).
Validar un sudoku — verificar una cuadrícula de sudoku en busca de conflictos, capacidad de resolución y unicidad de la solución con puzzle_sudoku_validate.
Explorar bancos de palabras — listar temas, buscar palabras por patrón, encontrar anagramas o elegir palabras aleatorias usando words_themes, words_match, words_anagram y words_random.
Ejecutar evaluaciones verificables de LLM — generar tareas de referencia reproducibles basadas en rompecabezas (eval_generate) y calificar respuestas por construcción (eval_check).

Documentación

PuzzleTide CLI — generador de sopas de letras, crucigramas y sudokus

Generador de sopas de letras, generador de crucigramas y generador + solucionador de sudokus en una sola CLI de generación de puzzles local-first — con hojas de trabajo PDF imprimibles, bancos de palabras iniciales, evaluaciones de LLM verificables y habilidades de agente incluidas. De los creadores de puzzletide.com.

Instalación

npm install -g puzzletide
ptide --version

El paquete instala ambos binarios:

ptide
puzzletide

Por qué generar puzzles con una CLI

Pide a un modelo de lenguaje que escriba una sopa de letras y obtendrás una cuadrícula donde la mitad de las palabras están rotas; pídele un sudoku y normalmente obtendrás uno con varias soluciones, o ninguna. Las cuadrículas son exactamente el tipo de resultado en el que los LLM son malos y el código determinista es bueno.

PuzzleTide CLI es ese código determinista:

Cada palabra de la sopa de letras se coloca y es verificable — las coordenadas de colocación son parte del resultado, y los generadores se prueban con propiedades.
Cada sudoku generado se verifica para que tenga exactamente una solución.
Cada crucigrama se valida contra sus propias pistas antes de devolverse.
Mismo --seed de entrada, mismo puzzle de salida, en cualquier máquina.

El paquete también incluye habilidades de agente SKILL.md, para que los agentes de codificación (Pi, Hermes, OpenClaw y otros sistemas basados en SKILL.md) recurran a la CLI en lugar de escribir cuadrículas a mano.

Modelo de comandos

ptide <namespace> <operation> [input] [options]   # for humans
ptide run <tool-id> [input] [options] --json      # canonical, for scripts/agents
ptide tools list | search <q> | info <id> | docs <id>
ptide agent manifest

Usa comandos cortos de forma interactiva e IDs de herramienta canónicos en automatización:

ptide sudoku generate --difficulty hard
ptide run puzzle.sudoku.generate --difficulty hard --json

Generador de sopas de letras

Ocho direcciones de colocación con preajustes fácil/medio/difícil, cuadrículas de tamaño automático (6–30), normalización de acentos/espacios/guiones. Las palabras provienen de flags, archivos o temas incluidos:

# Word search from your own words, printed in the terminal
ptide wordsearch generate --words "coral,shark,kelp,wave,tide"

# Themed printable word search (puzzle page + solution page)
ptide wordsearch generate --theme animals/ocean-animals --pdf ocean.pdf

# Kids mode: easy = forward-only words
ptide wordsearch generate --theme seasonal/halloween --difficulty easy

Generador de crucigramas

Colocación entrelazada con numeración estándar de crucigramas, validación de pistas y cuadrícula, y pistas de respaldo deterministas para palabras temáticas. Las palabras que no pueden entrelazarse se reportan en lugar de omitirse silenciosamente:

# Crossword with your clues
ptide crossword generate --words "PARIS: Capital of France; TOKYO: Capital of Japan"

# From a JSON file, as a printable PDF
ptide crossword generate --file words.json --pdf review.pdf --title "Unit 4 Review"

Generador y solucionador de sudokus

Sudokus fácil, medio, difícil y experto (17–21 dados) con garantía de unicidad, un solucionador instantáneo y un validador que reporta conflictos, resolubilidad y unicidad de la solución:

ptide sudoku generate --difficulty expert --seed 42
ptide sudoku solve "53..7....6..195....98....6.8...6...34..8.3..17...2...6.6....28....419..5....8..79"
ptide sudoku validate --file puzzle.txt
ptide daily        # today's daily sudoku, same for everyone on a given UTC day

Puzzles imprimibles: hojas de trabajo PDF y SVG

Cada generador acepta --pdf <file> para una hoja de trabajo lista para imprimir — página(s) del puzzle más una página de solución (--paper letter|a4, omite la clave de respuestas con --no-solution-page) — y --svg <file> para imágenes vectoriales. Las hojas de sopa de letras imprimibles y sudokus imprimibles para un paquete de clase están a un bucle de distancia:

for i in 1 2 3 4 5; do
  ptide sudoku generate --difficulty medium --seed "$i" --pdf "sudoku-$i.pdf" --title "Sudoku #$i"
done

¿Prefieres hojas ya hechas? La sopa de letras imprimible de misterio y asesinato es una favorita de los lectores, con cientos más en puzzles imprimibles.

Bancos de palabras y herramientas de palabras

30 temas iniciales (animales del océano, frutas, espacio, halloween, ...) — explora, busca, coincide patrones, anagramas, selecciones aleatorias. Trae tus propias listas mediante --words/--file, o juega con la colección completa curada en puzzletide.com:

ptide words themes --search dinosaur
ptide words match "c_r_l"        # crossword-style pattern matching
ptide words anagram coral

También hay un juego de ahorcado en la terminal: ptide play hangman.

Habilidades de agente

Pi puede cargar las habilidades incluidas directamente desde este paquete npm:

pi install npm:puzzletide

El manifiesto del paquete declara:

{
  "pi": {
    "skills": ["./skills"]
  }
}

Se incluyen cinco habilidades: sopa de letras, crucigrama, sudoku, puzzles imprimibles y evaluaciones de agente. Cada una prefiere la CLI local y verifica ptide, puzzletide, luego npx puzzletide. Las habilidades nunca instalan nada automáticamente; los agentes deben preguntar al usuario antes de instalar.

Servidor MCP para Claude Desktop, Cursor y cualquier cliente MCP

El paquete complementario puzzletide-mcp expone cada herramienta no interactiva a través del Protocolo de Contexto de Modelo — el mismo generador de sopas de letras, generador de crucigramas, generador/solucionador de sudokus, herramientas de palabras y evaluaciones, invocable desde Claude Desktop, Cursor, Windsurf o cualquier cliente MCP:

{
  "mcpServers": {
    "puzzletide": {
      "command": "npx",
      "args": ["-y", "puzzletide-mcp"]
    }
  }
}

Consulta docs/mcp.md para nombres de herramientas, argumentos y configuración por cliente.

Herramientas

El servidor MCP (y ptide run <tool-id>) expone 15 herramientas:

puzzle_wordsearch_generate: Genera una cuadrícula de sopa de letras a partir de palabras personalizadas, archivos o bancos de palabras temáticos — cada colocación verificable, imprimible mediante PDF/SVG.
puzzle_crossword_generate: Genera un crucigrama entrelazado con numeración estándar y pistas validadas.
puzzle_sudoku_generate: Genera sudokus fácil, medio, difícil o experto con una solución única garantizada.
puzzle_sudoku_solve: Resuelve un sudoku a partir de su cadena de 81 caracteres e informa si la solución es única.
puzzle_sudoku_validate: Valida una cuadrícula de sudoku — conflictos, resolubilidad y unicidad de la solución.
words_categories: Lista las categorías del banco de palabras.
words_themes: Lista o busca las listas de palabras temáticas incluidas.
words_list: Lista las palabras en un tema, filtradas por longitud o cantidad.
words_match: Encuentra palabras que coincidan con un patrón estilo crucigrama (c_r_l).
words_anagram: Encuentra anagramas de las letras dadas en el banco de palabras.
words_random: Elige una palabra aleatoria, opcionalmente de un tema.
words_stats: Estadísticas del banco de palabras.
eval_generate: Genera tareas de puzzle reproducibles y calificables objetivamente para la evaluación comparativa de LLMs y agentes.
eval_check: Califica las respuestas a las tareas de evaluación generadas por construcción — sin clave de respuestas confiable.
play_daily: Imprime el sudoku diario de hoy (el mismo para todos en un día UTC).

Evaluaciones de LLM verificables

Las respuestas de los puzzles son verificables sin una clave de respuestas: una respuesta de sudoku satisface las reglas y preserva los dados o no lo hace; una respuesta de sopa de letras deletrea la palabra a lo largo de una línea recta en la cuadrícula o no lo hace. Eso convierte a los puzzles en tareas de referencia limpias para evaluaciones de LLM — sin necesidad de un juez LLM:

ptide eval generate --type sudoku --n 20 --difficulty hard --seed 1 --out tasks.json
# ...run your model on tasks.json, collect [{id, answer}] ...
ptide eval check --tasks tasks.json --answers answers.json --json

La tupla (tipo, dificultad, n, semilla) determina completamente el conjunto de tareas, por lo que nombra un punto de referencia reproducible.

Uso como biblioteca

Los motores son TypeScript importable sin involucrar la CLI:

import { generateSudoku, generateWordSearch, wordSearchPdf } from 'puzzletide';

const sudoku = generateSudoku({ difficulty: 'hard', seed: 42 });
const search = generateWordSearch({
  words: ['coral', 'shark', 'kelp'],
  directions: ['E', 'S', 'SE'],
  seed: 7,
});
const pdfBytes = await wordSearchPdf(search, { title: 'Ocean Animals' });

Más documentación:

Versiones en línea

¿Prefieres un navegador?

Privacidad

Todo se ejecuta localmente. Sin cuenta, sin clave API, sin telemetría, sin acceso a la red.

Desarrollo

npm install
npm run build     # tsc → dist/
npm test          # vitest + fast-check property tests (build first: CLI tests run dist/)

Los bancos de palabras iniciales son listas genéricas y originales escritas para este paquete (scripts/wordbanks-source.json, compiladas con npm run build:wordbanks). Las contribuciones de temas son bienvenidas — añade una entrada al archivo fuente y ejecuta la compilación. La colección completa curada de bancos de palabras de PuzzleTide es propiedad de puzzletide.com y no forma parte de este repositorio.

Citar PuzzleTide CLI

Si usas PuzzleTide CLI en tu trabajo — por ejemplo, las evaluaciones de puzzles verificables en un benchmark de modelos — por favor, cítalo (o usa el botón "Citar este repositorio" de GitHub):

@software{puzzletide_cli,
  author  = {{Caravaca Labs}},
  title   = {PuzzleTide CLI: word search, crossword \& sudoku generator with verifiable LLM evals},
  year    = {2026},
  url     = {https://github.com/Caravaca-Labs/puzzletide-cli},
  note    = {From the makers of \url{https://puzzletide.com}}
}

Texto plano: "PuzzleTide CLI (Caravaca Labs, 2026), https://github.com/Caravaca-Labs/puzzletide-cli — de los creadores de https://puzzletide.com."