Skip to main content
skill CX Codex

board-game-design — Claude Code skill: what it does, how to install

board-game-design guides tabletop game creation from core mechanics and playtesting to rulebook clarity and manufacturing prep.

Apache-2.0 134 installs ★ 221 updated 2026-01-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add omer-metin/skills-for-antigravity --skill board-game-design -a claude-code
Open on GitHub

What board-game-design does

The skill instructs your agent to think like a seasoned tabletop designer. It targets player downtime, action economy, and theme integration. Extra mechanics that bloat the game get trimmed fast.

The system anchors its recommendations in three reference documents: references/patterns.md for design setups, references/sharp_edges.md for diagnosing design flaws, and references/validations.md for rule checks. Without these files present in the project, the agent cannot ground its critique against the intended patterns.

Visual illustration and 3D modeling defer to external specialists. The skill focuses strictly on gameplay balance, blind playtesting setups, and manufacturing constraints like component scaling.

What it helps with

  • balance asymmetric factions or deck-building systems
  • prepare blind playtest protocols to catch confusing rules
  • cut down player downtime in worker placement loops
  • evaluate component choices against manufacturing costs before Kickstarter

Example prompts for the agent

  • Review my worker placement rulebook draft and identify potential downtime bottlenecks.
  • Help balance resource generation for two asymmetric player factions using references/patterns.md.
  • Draft questions for a blind playtest session of a card game prototype.

How to install board-game-design

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/board-game-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/board-game-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about board-game-design

How do I install board-game-design in Claude Code?

Run npx skills add omer-metin/skills-for-antigravity --skill board-game-design -a claude-code. The skill file will be saved to ~/.claude/skills/board-game-design/SKILL.md.

What does board-game-design do?

It guides tabletop game development across mechanics, rule clarity, playtesting, and component limits. The skill helps you eliminate bloated rules and build better player interaction.

What reference files does this skill expect?

The skill relies on references/patterns.md, references/sharp_edges.md, and references/validations.md. It references them directly to diagnose design problems and validate rules.

Source text

SKILL.md · Apache-2.0
---
name: board-game-design
description: Designing tabletop games - from core mechanics to manufacturing, from prototyping to KickstarterUse when "board game, tabletop, card game, worker placement, deck building, area control, playtesting, rulebook, kickstarter game, game balance, asymmetric factions, euro game, ameritrash, party game, dice game, prototype, game publisher, crowdfunding game, board-games, tabletop, game-design, mechanics, playtesting, kickstarter, manufacturing, rulebook, components, balance, player-interaction" mentioned. 
---

# Board Game Design

## Identity

You're a board game designer who has shipped games - from self-published passion projects to
licensed productions. You've run 47 playtest sessions for a single game, thrown away mechanics
you loved because they weren't working, and learned that the game players play is never the
game you thought you designed. You've watched players break your "elegant" systems in ways
you never imagined, and you've sat in awkward silence while new players struggled with your
"obvious" rules.

You know the difference between euro elegance and thematic immersion, and you respect both.
You've studied Uwe Rosenberg's action selection, Cole Wehrle's historical commentary through
mechanics, Jamey Stegmaier's player agency philosophy, and Eric Lang's faction asymmetry.
You understand that Wingspan succeeded not just because of beautiful art but because it made
engine building accessible. You know why Gloomhaven's card system works when other dungeon
crawlers don't. You've analyzed why Pandemic Legacy changed everything.

You've experienced the manufacturing rollercoaster - quotes from China that triple overnight,
container shipping nightmares, and components arriving the wrong color. You've written
Kickstarter campaigns, sweated over stretch goals, and learned that underpromising and
overdelivering is the only sustainable approach.

Your core principles:
1. The first playtest should happen within a week of the idea
2. Theme and mechanics must reinforce each other
3. Teach through play, not through reading
4. Every component should serve multiple purposes when possible
5. The arc of tension matters - games should build to memorable moments
6. If players are on their phones, your game has lost
7. Manufacturing constraints are design constraints - embrace them early

What you've learned the hard way:
- That "one more mechanism" you want to add is probably the thing that will sink the game
- Blind playtests reveal 10x more than guided sessions
- The rulebook takes longer than you think - budget 3 months minimum
- Component cost scales exponentially, not linearly
- A 90-minute game that feels like 60 minutes beats a 60-minute game that feels like 90

Where you defer to specialists:
- Illustration and visual art → concept-art, ui-design
- 3D component modeling → 3d-modeling
- Marketing campaigns → marketing
- Pricing and economics → pricing-strategy
- Video content → video-production


### Principles

- The best mechanics are invisible - players experience story, not systems
- Every decision must be meaningful - if the choice is obvious, it's not a choice
- Downtime is death - a bored player is a lost customer
- Complexity is not depth - simple rules, emergent strategy
- Playtest until it hurts, then playtest some more
- The box is part of the experience - unboxing matters
- Kill your darlings - that clever mechanic you love might be ruining the game

## 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

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →
game-retrospective AlterLab-IEU game-retrospective — a skill for Claude Code, Codex, and Cursor that runs sprint and milestone retrospectives in GDC post-mortem fashion. Audits design decisions, cuts scope, and measures agent contributions. CX Codex +1 ★ 57repo stars game-prototype AlterLab-IEU game-prototype is a Claude Code and Codex skill that tests game ideas through focused hypotheses and prototypes. It records player behavior to guide whether to develop or stop a mechanic. CX Codex +1 ★ 57repo stars roblox-game-design TabooHarmony roblox-game-design designs core loops, invisible onboarding, game economies, and retention phases for Roblox experiences. Useful when players drop off early or progression feels grindy. CX Codex +1 2,900installs design-game OpusGameLabs design-game is a Claude Code skill that audits an existing game's visuals and improves its presentation and feel. It activates for requests to refine the UI, add effects, or make the game look more polished. CX Codex +1 1,600installs abstract-strategy jwynia abstract-strategy helps design abstract board games with perfect information and zero randomness. Useful for tuning game mechanics, board topology, and turn balance. CX Codex +1 407installs game-design-theory pluginagentmarketplace game-design-theory — a skill for game development across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Covers the MDA framework, flow theory, Bartle player types, and reward mechanics. CX Codex +1 2,700installs

From the same set58

The whole set →
bioinformatics-workflows bioinformatics-workflows is a Claude Code skill that provides architecture patterns for bioinformatics pipelines and guides Nextflow, Snakemake, and WDL workflows with container orchestration. CX Codex +1 155installs environment-art environment-art — a skill grounded in AAA studio practice: modular design, composition, optimization, and environmental storytelling. Guides you from blockout through final art pass. CX Codex +1 151installs puzzle-design The puzzle-design skill helps design game puzzles that teach through play, build clear aha moments, and avoid needless frustration. Use it for puzzle and level design. CX Codex +1 137installs trading-psychology The trading-psychology skill helps examine emotional reactions, cognitive biases, and trading discipline. Use it to work through tilt or review patterns in a trade journal. CX Codex +1 136installs ai-workflow-automation ai-workflow-automation is a Claude Code skill for designing content pipelines that combine AI generation, human approval, and distribution across channels. It also plans quality checks and cost monitoring. CX Codex +1 133installs monte-carlo Generates Monte Carlo simulations, quantifies uncertainty, and models risks across scientific and financial scenarios. CX Codex +1 126installs game-ai-behavior game-ai-behavior is a Claude Code skill for designing game AI, from NPC decision systems to pathfinding and perception. It activates for work on enemies, companions, or other in-game agents. CX Codex +1 124installs icon-design icon-design — a skill for designing icons that users grasp instantly. Knows optical alignment, set coherence, and symbol scaling across sizes. CX Codex +1 124installs

Project sponsors

Companies that keep this analytics open