map-sheets

Builds, edits, and verifies survey-sheet game maps under golden-pin and blind-pass verification.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/Raynos/kami-kakushi --skill map-sheets-raynos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-sheets
Source: https://github.com/Raynos/kami-kakushi/tree/main/.claude/skills/map-sheets
Command: npx skills add https://github.com/Raynos/kami-kakushi --skill map-sheets-raynos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game map changes are easy to break visually and hard to review objectively. This Skill routes every map edit — moving zones, adding landmarks, drawing new terrain primitives, or designing whole new tier sheets — through a deterministic pin-guarded workflow with golden snapshot tests and blind-pass rubric verification, so visual regressions are caught and explained before shipping. ## Core Features & Use Cases - Job routing: Directs each map task (move/resize, add zone, new primitive, tier deltas, new tier sheet) to the correct authoring guide and procedure. - Golden pin discipline: Enforces vitest golden-snapshot checks after every edit, with a capture-review-regen loop for intentional visual changes. - Blind-pass verification: Runs a scoped blind-pass workflow on edited sheets, requiring all mandatory rubric lines to pass before committing. - Use Case: When asked to "add a zone to the T1 map" or "build the T2 valley sheet", the Skill enforces spec-first design, deterministic seeded rendering, and verified commits. ## Quick Start Ask the AI to add a new zone to the T1 map and verify it with the golden pin tests and blind-pass report.

Frequently Asked Questions about map-sheets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a zone to a game map sheet?

Adding a zone follows the map-authoring guide section 3: define the seal, ground, and roster as data in layout.ts and nodes.ts rather than hardcoding coordinates in painters. After editing, run the map-sheets vitest suite to confirm the golden pin stays green.

How do I create a new tier map sheet like T2 or T3?

New tier sheets follow map-styles.md section 4 and are spec-first: a written spec must be reviewed by a human before any building starts. This gate is mandatory and cannot be skipped for new scale-class sheets.

What happens when the golden map test goes red?

A red pin means the visual output changed. Capture audit screenshots with map-audit-shots.mjs, inspect the PNGs yourself, then regenerate the golden hash with UPDATE_MAP_GOLDEN=1 and commit it alongside the change. Never regenerate an unexplained red.

Can I use Math.random for map generation?

No. All rendering must be deterministic: use the seeded rng(seed) function with sub-seeds as template strings, and use Andon design tokens instead of raw hex colors. Math.random and Date are prohibited.

When is a blind-pass review required for map changes?

Any look-bearing change requires a scoped blind-pass run against the edited sheet, with the dev server running. Full both-sheet passes are reserved for layout geometry moves, milestone closes, or new tier acceptance.