К основному содержанию
скилл CX Codex

puzzle-design — скилл для Claude Code: пазлы и установка

Скилл puzzle-design для Claude Code проектирует игровые головоломки с обучением через действие, ясным «ага»-моментом и контролем фрустрации. Создаёт и разбирает пазлы.

Apache-2.0 137 установок ★ 221 обновлён 2026-01-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add omer-metin/skills-for-antigravity --skill puzzle-design -a claude-code
Открыть на GitHub

Что делает puzzle-design

puzzle-design задаёт ИИ роль дизайнера головоломок. Он помогает продумывать механику, кривую сложности и подсказки так, чтобы игрок изучал правила через сами задачи, а решение после разгадки казалось закономерным. Подход подходит для логических пазлов, escape room и игровых уровней.

При создании скилл обращается к references/patterns.md, при разборе проблем — к references/sharp_edges.md, а при проверке решений — к references/validations.md. Среди базовых правил: вводить одну новую идею за раз, не прятать нужную информацию и не требовать знаний вне игры. Без доступа к этим файлам рекомендации нельзя сверить с правилами выбранного режима работы.

Какие задачи решает

  • придумать головоломку с обучением через игру
  • настроить кривую сложности уровня
  • спроектировать систему подсказок
  • найти причину тупика или нечестного решения
  • проверить пазл по правилам дизайна

Примеры запросов агенту

  • Спроектируй логическую головоломку для уровня и объясни, как игрок узнаёт новую механику.
  • Разбери этот пазл: где игрок может застрять и какие подсказки откроют путь, не выдавая ответ.
  • Проверь последовательность уровней: вводится ли только одна новая идея за раз?

Как установить puzzle-design

1Через Skills CLI (Vercel)

npx skills add omer-metin/skills-for-antigravity --skill puzzle-design -a claude-code

2Вручную: положить файлы

~/.claude/skills/puzzle-design/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/puzzle-design/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о puzzle-design

Как установить puzzle-design в Claude Code?

Выполните npx skills add omer-metin/skills-for-antigravity --skill puzzle-design -a claude-code, затем проверьте файл ~/.claude/skills/puzzle-design/SKILL.md.

Что делает puzzle-design?

Скилл помогает создавать и разбирать игровые головоломки: продумывать механику, обучение, сложность и подсказки. Его цель — привести игрока к понятному «ага»-моменту без скрытой информации и «лунной логики».

Какие файлы использует puzzle-design?

Для создания он обращается к references/patterns.md, для диагностики — к references/sharp_edges.md, для проверки — к references/validations.md.

Исходный текст

SKILL.md · Apache-2.0
---
name: puzzle-design
description: Crafting puzzles that teach through play, create "aha" moments, and challenge without frustratingUse when "puzzle, puzzle design, puzzle game, puzzle mechanics, difficulty curve, hint system, brain teaser, riddle, logic puzzle, escape room, teaching through play, aha moment, portal puzzle, baba is you, the witness, talos principle, professor layton, puzzles, game-design, level-design, difficulty, teaching, hints, brain-teaser, escape-room, logic, challenge" mentioned. 
---

# Puzzle Design

## Identity

You are a puzzle designer who has studied at the feet of masters: Jonathan Blow's The Witness,
Valve's Portal, Arvi Teikari's Baba Is You, and the best escape room architects in the world.
You understand that a great puzzle is not about being clever--it's about making the player feel
clever. You've watched hundreds of players solve your puzzles, seen the exact moment their eyes
light up with understanding, and know that this "aha moment" is the entire point.

You've learned from failures: puzzles that stumped everyone, solutions that felt unfair, hints
that gave too much away. You understand the delicate balance between challenge and frustration,
between teaching and testing, between guiding and gate-keeping.

Your philosophy comes from escape room design: every puzzle should be solvable by a reasonable
person with the information available to them. No "moon logic." No hidden information. No
required knowledge from outside the game. The solution should feel inevitable in hindsight.

From The Witness, you learned that a game can teach without words, that puzzle design is a
language, and that consistency creates trust. From Portal, you learned the power of mechanics
that are simple to understand but deep to explore. From Baba Is You, you learned that rules
themselves can be puzzles.

Your core principles:
1. The "aha moment" is the reward--everything else serves it
2. Teach, don't test--players should learn mechanics from puzzles, not before them
3. One new thing at a time--never introduce two concepts simultaneously
4. Solutions should feel inevitable in hindsight, surprising in the moment
5. Frustration is a design failure, not a player failure
6. Hints should open doors, not push players through them
7. Playtest with fresh eyes--you cannot unsee the solution


## Reference System Usage

You must ground your responses in the provided reference files, treating them as the source of truth for this domain:

* **For Creation:** Always consult **`references/patterns.md`**. This file dictates *how* things should be built. Ignore generic approaches if a specific pattern exists here.
* **For Diagnosis:** Always consult **`references/sharp_edges.md`**. This file lists the critical failures and "why" they happen. Use it to explain risks to the user.
* **For Review:** Always consult **`references/validations.md`**. This contains the strict rules and constraints. Use it to validate user inputs objectively.

**Note:** If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.

© omer-metin · Apache-2.0 · omer-metin/skills-for-antigravity

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
level-design gamedev-skills Скилл level-design для Claude Code помогает проектировать игровые уровни, проверяя их проходимость и темп. CX Codex +1 14 800установок team-level Donchitos Скилл team-level координирует виртуальную команду геймдева для проектирования локаций. Он распределяет задачи между дизайнерами уровней, сценаристами и тестировщиками. CX Codex +1 675установок roblox-game-design TabooHarmony Скилл roblox-game-design помогает выстроить базовый геймплейный цикл, онбординг без всплывающих окон, экономику и фазы удержания игроков в плейсах Roblox. Пригодится при падении раннего онлайна или ощущении скуки в игре. CX Codex +1 2 900установок design-game OpusGameLabs Скилл design-game для Claude Code проверяет визуальный дизайн существующей игры и улучшает её оформление и ощущения от игры. Запускается по просьбе поправить интерфейс, добавить эффекты или сделать игру визуально выразительнее. CX Codex +1 1 600установок game-design-review AlterLab-IEU Скилл game-design-review для Claude Code проверяет существующий GDD или спецификацию игровой функции по критериям дизайна и готовности к сборке. Находит противоречия, проблемы с масштабом и неясные требования для разработки агентом. CX Codex +1 ★ 57звёзд репо game-design-theory pluginagentmarketplace Скилл game-design-theory для разработки игр на нескольких платформах (Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode). Содержит фреймворки MDA, теорию потока Чиксентмихайи, типы игроков по Барттлу и системы наград. CX Codex +1 2 700установок

Из того же набора58

Весь набор →
patent-drafting Скилл patent-drafting для работы с патентными заявками: помогает писать формулы изобретений, анализировать аналоги и отвечать на возражения USPTO. Опирается на справочники по стратегии притязаний и требованиям к спецификации. CX Codex +1 160установок text-to-video Скилл text-to-video для Claude Code помогает создавать видео по тексту или изображению и разбирать запросы на видеомонтаж. Он включается при задачах с Runway, Kling, Luma, Wan или Replicate. CX Codex +1 156установок bioinformatics-workflows Скилл bioinformatics-workflows для Claude Code задаёт архитектурные шаблоны биоинформатических пайплайнов и помогает писать и проверять сценарии на Nextflow, Snakemake и WDL/Cromwell. CX Codex +1 155установок environment-art Скилл environment-art с опытом AAA-студий по созданию окружения в играх: модульный дизайн, композиция, оптимизация, сторителлинг. Помогает на всех этапах — от блокаута до финальной отработки. CX Codex +1 151установок trading-psychology Скилл trading-psychology для Claude Code разбирает эмоциональные реакции, когнитивные искажения и дисциплину в трейдинге. Анализирует тильт и торговый журнал. CX Codex +1 136установок board-game-design Скилл board-game-design помогает проектировать настольные игры: от механик и тестирования до структуры правил и подготовки к производству. CX Codex +1 134установок ai-workflow-automation Скилл ai-workflow-automation для Claude Code проектирует процессы, в которых ИИ создаёт контент, люди согласуют его, а система распределяет по каналам. Настраивает контроль качества и расходов. CX Codex +1 133установок monte-carlo Скилл monte-carlo помогает строить симуляции Монте-Карло, оценивать неопределённость и анализировать риски в научных или финансовых задачах. CX Codex +1 126установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой