tabletopkit — Claude Code skill: what it does, how to install
Guides work on visionOS spatial board games using TabletopKit, including game pieces, turns, participant sync, and RealityKit rendering.
npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a claude-codeWhat tabletopkit does
This skill guides implementation of visionOS spatial board games with TabletopKit. It covers table surfaces, player seats, pieces, cards, and dice, with state changes expressed through TabletopAction. Visual entities use RealityKit, while TabletopInteraction handles gesture-based equipment input.
Multiplayer work requires the Group Activities capability and USDZ assets for tables, pieces, cards, and dice in a RealityKit content bundle. State can be read with withCurrentSnapshot(_:); when automatic updates are off, call update(deltaTime:) every frame. The simulator is limited to single-player layout checks, so it cannot validate multiplayer behaviour. TabletopInteraction.Configuration needs visionOS 2.2+, while custom actions and extended state require visionOS 26.0+.
What it helps with
- build a visionOS game table and board
- define stateful pieces, cards, and dice
- assign player seats and turn control
- sync game actions with Group Activities
- handle object gestures and table physics
Example prompts for the agent
- Create a visionOS board game with
TabletopKit, a table, two player seats, and pawns. - Add cards and dice with state, then render their entities with
RealityKit. - Set up turn actions with
TabletopActionand multiplayer state throughGroup Activities.
How to install tabletopkit
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a claude-code2Manually: put the files in place
~/.claude/skills/tabletopkit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tabletopkit/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a codex2Manually: put the files in place
.agents/skills/tabletopkit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a cursor2Manually: put the files in place
.cursor/skills/tabletopkit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills tabletopkit2Manually: put the files in place
.github/skills/tabletopkit/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/tabletopkitManually: put the files in place
.devin/skills/tabletopkit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tabletopkit
How do I install tabletopkit in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a claude-code, then run npx skills add dpearson2699/swift-ios-skills --skill tabletopkit -a claude-code again. The skill file is at ~/.claude/skills/tabletopkit/SKILL.md.
What does tabletopkit do?
It guides development of visionOS spatial board games with TabletopKit. Its scope includes tables, equipment, turns, interactions, and RealityKit rendering.
What is required for multiplayer gameplay?
Add the Group Activities capability in Signing & Capabilities. Table, piece, card, and dice assets also need to be available as USDZ content for RealityKit.
