Puzzle Activity Planner
sickn33/agentic-awesome-skills
Plan puzzle-based activities for classrooms, parties, and events with pre-configured generator links
Puzzle Activity Planner workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
$ npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install diegosouzapw/awesome-omni-skills puzzle-activity-planner --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills_omni/puzzle-activity-planner .claude/skills/puzzle-activity-planner && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "puzzle-activity-planner" agent skill from https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-planner into .claude/skills/puzzle-activity-planner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "puzzle-activity-planner", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-plannerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install diegosouzapw/awesome-omni-skills puzzle-activity-planner --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills_omni/puzzle-activity-planner .agents/skills/puzzle-activity-planner && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "puzzle-activity-planner" agent skill from https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-planner into .agents/skills/puzzle-activity-planner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "puzzle-activity-planner", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install diegosouzapw/awesome-omni-skills puzzle-activity-planner --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills_omni/puzzle-activity-planner .cursor/skills/puzzle-activity-planner && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "puzzle-activity-planner" agent skill from https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-planner into .cursor/skills/puzzle-activity-planner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "puzzle-activity-planner", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/diegosouzapw/awesome-omni-skills.git --path skills_omni/puzzle-activity-planner--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install diegosouzapw/awesome-omni-skills puzzle-activity-planner --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills_omni/puzzle-activity-planner .gemini/skills/puzzle-activity-planner && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "puzzle-activity-planner" agent skill from https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-planner into .gemini/skills/puzzle-activity-planner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "puzzle-activity-planner", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install diegosouzapw/awesome-omni-skills puzzle-activity-plannerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills_omni/puzzle-activity-planner .github/skills/puzzle-activity-planner && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "puzzle-activity-planner" agent skill from https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-planner into .github/skills/puzzle-activity-planner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "puzzle-activity-planner", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install diegosouzapw/awesome-omni-skills puzzle-activity-planner --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills_omni/puzzle-activity-planner .opencode/skills/puzzle-activity-planner && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "puzzle-activity-planner" agent skill from https://github.com/diegosouzapw/awesome-omni-skills/tree/main/skills_omni/puzzle-activity-planner into .opencode/skills/puzzle-activity-planner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "puzzle-activity-planner", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
puzzle-activity-plannerPuzzle Activity Planner workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
Puzzle Activity Planner is an agent skill from diegosouzapw/awesome-omni-skills. Puzzle Activity Planner workflow skill. Use this skill when the user needs plan puzzle-based activities for classrooms, parties, and events with pre-configured generator links, and the operator should preserve the upstream workflow, copied support files, and provenance before merging or handing off.
Its SKILL.md is about 3.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 21 other files, including scripts, reference files and assets (for example `ATTRIBUTION.md`, `OMNI_ENHANCED.json` and `ORIGIN.md`).
The repository describes itself as: Public repository of AI coding skills, curated improved best-practice skills, and runtime surfaces for CLI, API, MCP, and A2A. The licence is MIT.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit c3af004. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Puzzle Activity Planner loads about 3.9k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 81 tokens; SKILL.md has 1,808 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from diegosouzapw/awesome-omni-skills at commit c3af004, republished under its MIT licence (© diegosouzapw). 1,808 words, ~3,857 tokens.
.claude/skills/puzzle-activity-planner/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.This skill packages the upstream puzzle-activity-planner workflow into the Omni Skills format without hiding its origin.
Use it when a user wants a planned puzzle activity, not just a single puzzle. The expected deliverable is a practical plan for a classroom, party, team-building session, or event, with puzzle choices, timing, materials, facilitation notes, accessibility adjustments, and optional generator links.
Preserve upstream provenance and any copied support files during review or handoff. If the upstream package includes named puzzle generators or pre-configured links, treat them as implementation aids to verify before use, not automatic endorsements.
Use this skill when the request requires planning or reviewing a puzzle-based activity such as:
Do not use this skill when the user actually needs:
If the request is mostly about curriculum design, event logistics, or accessibility remediation beyond puzzle activity planning, narrow the task or hand off to a more appropriate skill.
| Situation | Start here | Why it matters |
|---|---|---|
| First-time review of the imported skill | metadata.json and ORIGIN.md | Confirms source repository, import path, and provenance before editing or handoff |
| Building a new puzzle plan | Intake fields in this SKILL.md | Prevents weak recommendations caused by missing audience, timing, or accessibility details |
| Quality-checking a draft plan | references/review-criteria.md | Gives a compact rubric for audience fit, safety, accessibility, and execution readiness |
| Need a concrete model | examples/review-example.md | Shows how to turn a vague request into a structured, usable plan |
| Reviewing upstream generator links | Workflow step 6 in this file | Keeps external links optional and manually verified before sharing |
Collect these before proposing puzzle formats:
If key intake fields are missing, ask concise follow-up questions before planning.
Confirm the task really is puzzle-activity planning.
Distinguish between “make me a puzzle” and “plan an activity that uses puzzles.”
Capture the intake.
Get the minimum details needed to avoid unsafe, inaccessible, or impractical suggestions.
Define the success condition.
Decide what success means for this setting:
Choose puzzle formats before tools.
Match puzzle type to audience and goal.
| Goal | Strong formats | Usually weaker fits |
|---|---|---|
| Quick warm-up | word search, matching, simple cipher, mini-riddle set | long logic grid, multi-step escape chain |
| Curriculum review | crossword, matching, sequencing, clue-based worksheet, short logic puzzle | puzzles that rely mostly on trivia outside the lesson |
| Party entertainment | scavenger clues, themed ciphers, jigsaw clues, collaborative decoding | text-dense worksheets for young children |
| Team-building | multi-role clue sets, station rotation, logic chain, collaborative reconstruction | solo-only puzzles with long waiting time |
| Mixed-age play | layered hints, parallel difficulty tracks, picture-plus-text clues | culturally narrow clues, heavy reading load, speed-only tasks |
Set difficulty and pacing.
For each activity, specify:
Treat generator links as optional accelerators.
If the upstream skill includes pre-configured generator links, preserve them for provenance, but verify before recommending them:
Add facilitation notes.
Include setup, materials, transitions, supervision assumptions, and when to offer hints.
Run accessibility and safety checks.
Do not finalize the plan until those sections below are satisfied.
Produce the final deliverable.
A good final answer usually includes:
Use this structure when producing the plan:
For each puzzle, include:
Puzzle difficulty should come from the intended challenge, not from poor wording or inaccessible presentation.
Before handoff, check:
Minimum inclusion standard for most plans:
Use targeted safety judgment, especially for children or mixed-age groups.
Check the following before approving a plan:
Use this rule when uncertain:
If the audience includes children and the plan involves small props, free movement, or external websites, require adult review before use.
Before final handoff, verify:
Use references/review-criteria.md for a compact scoring pass.
references/review-criteria.md - compact review rubric for fit, accessibility, safety, and readinessexamples/review-example.md - worked example from vague request to final planConsider another skill or narrower workflow when the request shifts toward:
See examples/review-example.md for a full worked example including:
This enhanced version preserves the imported identity and intent of the upstream puzzle-activity-planner skill.
If copied upstream files contain sections such as puzzle types supported, URL parameters, output format, or limitations, keep them available during review. Preserve provenance artifacts such as metadata.json and ORIGIN.md when merging or handing off. Do not remove source lineage merely because the final wording is improved.
© diegosouzapw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 16 other files (scripts, references, assets) in skills_omni/puzzle-activity-planner of diegosouzapw/awesome-omni-skills.
Open the folder on GitHubat commit c3af004
Puzzle Activity Planner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Puzzle Activity Planner this skilldiegosouzapw/awesome-omni-skills | 159 | — | ~3.9k | Automated safety check: Pass | MIT | |
| Puzzle Activity Plannersickn33/agentic-awesome-skills | 47k | 1 repos | ~790 | Automated safety check: Pass | MIT | |
| Plannerpenpot/penpot | 61k | — | ~2.7k | Automated safety check: Pass | MPL-2.0 | |
| Agent Plannerruvnet/ruflo | 74k | 2 repos | ~1.2k | Automated safety check: Pass | MIT | |
| Agent Goal Plannerruvnet/ruflo | 74k | 3 repos | ~842 | Automated safety check: Pass | MIT | |
| Modeling Activation MetricsPostHog/posthog | 40k | — | ~1.4k | Automated safety check: Pass | Custom licence |
sickn33/agentic-awesome-skills
Plan puzzle-based activities for classrooms, parties, and events with pre-configured generator links
penpot/penpot
Read-only planning and architecture analysis — produce a structured implementation plan with task breakdown, acceptance criteria, sizing, and checkpoints.
ruvnet/ruflo
Agent skill for planner - invoke with $agent-planner. An agent skill from ruvnet/ruflo.
ruvnet/ruflo
Agent skill for goal-planner - invoke with $agent-goal-planner
PostHog/posthog
Build reusable activation models — an activation-rate metric and a per-user/per-account activated flag — on either PostHog data-warehouse views (HogQL) or an external dbt project.
ruvnet/ruflo
Agent skill for code-goal-planner - invoke with $agent-code-goal-planner
diegosouzapw/awesome-omni-skills
Content Creator workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
diegosouzapw/awesome-omni-skills
Helm Chart Scaffolding workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
diegosouzapw/awesome-omni-skills
Prompt Engineering Patterns workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
diegosouzapw/awesome-omni-skills
Prompt Engineering Patterns workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
diegosouzapw/awesome-omni-skills
📝 Prompt Library workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
diegosouzapw/awesome-omni-skills
Protocol Reverse Engineering workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.
Puzzle Activity Planner workflow skill. An agent skill from diegosouzapw/awesome-omni-skills. Puzzle Activity Planner is an agent skill from diegosouzapw/awesome-omni-skills. Puzzle Activity Planner workflow skill.
Puzzle Activity Planner fits situations like: the user needs plan puzzle-based activities for classrooms; events with pre-configured generator links; the operator should preserve the upstream workflow; copied support files.
Run `npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a claude-code`. Or copy the skill folder (skills_omni/puzzle-activity-planner in diegosouzapw/awesome-omni-skills) into .claude/skills/puzzle-activity-planner in your project. Claude Code loads it when a task matches its description.
Run `npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a codex`. Or copy the skill folder (skills_omni/puzzle-activity-planner in diegosouzapw/awesome-omni-skills) into .agents/skills/puzzle-activity-planner in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add diegosouzapw/awesome-omni-skills --skill puzzle-activity-planner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/puzzle-activity-planner, .gemini/skills/puzzle-activity-planner, .github/skills/puzzle-activity-planner and .opencode/skills/puzzle-activity-planner in your project.
Going by SKILL.md and its folder, Puzzle Activity Planner needs Python for the scripts in its folder. Our summary lists: Python 3.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Puzzle Activity Planner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.9k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Puzzle Activity Planner: Puzzle Activity Planner (sickn33/agentic-awesome-skills, 47k stars), Planner (penpot/penpot, 61k stars), Agent Planner (ruvnet/ruflo, 74k stars) and Agent Goal Planner (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
diegosouzapw (a GitHub user) maintains it in diegosouzapw/awesome-omni-skills, which has 159 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on July 8, 2026.
Source: diegosouzapw/awesome-omni-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.