# Puzzletide Word Search

> Use this skill whenever the user asks for a word search puzzle — themed, custom word lists, kids activities, classroom worksheets, printable PDFs, or puzzle data for an app. Generates correct grids locally with the PuzzleTide CLI instead of hand-writing letters.

- **Type:** Skill
- **Install:** `agentstack add skill-caravaca-labs-puzzletide-cli-puzzletide-word-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Caravaca-Labs](https://agentstack.voostack.com/s/caravaca-labs)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Caravaca-Labs](https://github.com/Caravaca-Labs)
- **Source:** https://github.com/Caravaca-Labs/puzzletide-cli/tree/main/skills/puzzletide-word-search

## Install

```sh
agentstack add skill-caravaca-labs-puzzletide-cli-puzzletide-word-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PuzzleTide Word Search

Generate word search puzzles with the local PuzzleTide CLI.

**Never hand-write a word search grid.** Language models reliably produce
grids where words are misaligned, broken, or missing entirely. The CLI places
every word deterministically and is property-tested: every word in the list
is guaranteed to be findable in the grid.

Prefer the local CLI. Check availability in this order:

```bash
ptide --version
puzzletide --version
npx puzzletide --version
```

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

## Generate from a custom word list

```bash
ptide wordsearch generate --words "coral,shark,kelp,wave,tide"
```

## Generate from a bundled themed word bank

```bash
ptide words themes --search dinosaur          # find a theme id
ptide wordsearch generate --theme animals/dinosaurs --count 12
```

## Printable worksheet (PDF with solution page) or SVG

```bash
ptide wordsearch generate --theme animals/ocean-animals --pdf ocean.pdf
ptide wordsearch generate --words "..." --svg puzzle.svg --title "Ocean Fun"
```

## Useful options

- `--difficulty easy|medium|hard` — easy is forward-only (great for kids), hard uses all 8 directions including backwards.
- `--size ` — square grid size (6-30); auto-computed if omitted.
- `--seed ` — reproducible output; the seed is printed with every puzzle.
- `--json` — structured data (grid, word placements with coordinates) for apps and automation.

## Canonical form for automation

```bash
ptide run puzzle.wordsearch.generate --theme space --json
```

## Links

- Play online: [PuzzleTide word search](https://puzzletide.com/word-search)
- Worksheets: [printable puzzles](https://puzzletide.com/printable) and a [word search maker](https://puzzletide.com/maker) at [puzzletide.com](https://puzzletide.com)
- Source and docs: [GitHub](https://github.com/Caravaca-Labs/puzzletide-cli) · [npm](https://www.npmjs.com/package/puzzletide) · [CLI reference](https://github.com/Caravaca-Labs/puzzletide-cli/blob/main/docs/cli.md)

## Safety

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Caravaca-Labs](https://github.com/Caravaca-Labs)
- **Source:** [Caravaca-Labs/puzzletide-cli](https://github.com/Caravaca-Labs/puzzletide-cli)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-caravaca-labs-puzzletide-cli-puzzletide-word-search
- Seller: https://agentstack.voostack.com/s/caravaca-labs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.