# tinyswords-tilemap

Builds Tiny Swords tilemaps: 64x64 grid, height levels with shadows, animated water foam and five terrain colour variants.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 37 repo stars
- Author: chongdashu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chongdashu/phaserjs-tinyswords/tree/HEAD/.claude/skills/tinyswords-tilemap/SKILL.md
- Updated: 2026-01-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tinyswords-tilemap

## What it does

The skill splits a map into six parts: water fill, foam, flat ground, shadows, raised ground and stairs. The agent stacks them from the bottom up and adds a pair of layers for every height level. Tiles are 64x64, shadow sprites are 128x128 and sit on the same grid, so their edges overlap the neighbouring cells.

A shadow belongs on the tile directly beneath the surface you can walk on. Push it flush against the cliff and the height reading collapses. Foam has its own catch: give every sprite a separate start frame, or the shoreline pulses in lockstep.

Five terrain colours ship as `Tilemap_color1.png` through `Tilemap_color5.png`. Any order works, though neighbouring levels read better with contrast between them. Stairs take one centre piece next to walkable ground and two pieces when cliffs flank them. Full file paths are listed in `references/asset-paths.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill tinyswords-tilemap -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tinyswords-tilemap/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tinyswords-tilemap/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill tinyswords-tilemap -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tinyswords-tilemap/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill tinyswords-tilemap -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tinyswords-tilemap/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install chongdashu/phaserjs-tinyswords .claude/skills/tinyswords-tilemap
```

2. **Manually: put the files in place**
- File: `.github/skills/tinyswords-tilemap/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill tinyswords-tilemap -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/chongdashu/phaserjs-tinyswords --path .claude/skills/tinyswords-tilemap
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tinyswords-tilemap/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill tinyswords-tilemap -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/chongdashu/phaserjs-tinyswords/tree/HEAD/.claude/skills/tinyswords-tilemap/SKILL.md

## When to use it
- stack terrain into height layers with shadows
- offset foam frames so the shoreline stops pulsing
- choose a terrain colour per elevation
- match the stair piece to the surrounding cliff
- place shadows one tile below walkable ground

## Example prompts
- Build an island map on `Tilemap_color2.png` with a flat beach, two raised levels and a stair between them.
- Check the layer order in my scene and point out shadows that sit off the tile below the platform.
- Give each foam sprite a different start frame so the waves stop moving together.

## Similar
- [loading-assets](https://affpapa.org/en/nevibecode/skills/loading-assets.md) — skill · 1100 installs
- [godot-tilemap](https://affpapa.org/en/nevibecode/skills/godot-tilemap.md) — skill · 11900 installs
- [unity-tilemap-2d](https://affpapa.org/en/nevibecode/skills/unity-tilemap-2d.md) — skill · 10900 installs
- [godot-tilemap-mastery](https://affpapa.org/en/nevibecode/skills/godot-tilemap-mastery.md) — skill · 520 installs
- [godot4-isometric-tilemap](https://affpapa.org/en/nevibecode/skills/godot4-isometric-tilemap.md) — skill · ★ 51 repo stars
- [spritecook-workflow-essentials](https://affpapa.org/en/nevibecode/skills/spritecook-workflow-essentials.md) — skill · 1200 installs

From the same set: [chongdashu/phaserjs-tinyswords](https://affpapa.org/en/nevibecode/by/chongdashu/phaserjs-tinyswords.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
