items

Define and validate game item definitions against a strict schema.

14|7|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill items
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: items
Source: https://github.com/nikolaj-lat/World-Puppeteer/tree/main/.claude/skills/items
Command: npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill items

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a formal schema and rules for creating consistent, reusable item definitions to speed up game content authoring and reduce data errors.

Core Features & Use Cases

  • Centralized item schema with required fields and conditional fields
  • Clear rules for bonuses, categories, and slots
  • Use case: define a new weapon with specific bonuses or a readable item with content for in-game lore

Quick Start

Create a new item entry in tabs/items.json with name, category, description, and bonuses, then run the validator to confirm it conforms to the schema.

Frequently Asked Questions about items

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

FAQPage Schema
How do I standardize game item definitions to prevent inconsistent data?

Standardize game item definitions by applying a strict schema that enforces required and optional fields during content authoring. This prevents inconsistent item data and ensures all entries conform to runtime-safe structures before validation.

How do I validate item bonuses and categories before runtime?

Validate item bonuses and categories by defining them in an items.json file and running a schema validator. This confirms that conditional fields, bonus rules, and category slots conform to strict definitions and are runtime-safe.

What is the best way to define game items for the Voyage engine?

The best way to define game items for the Voyage engine is using a centralized item schema. It enforces required fields, standardizes item creation, and ensures compatibility with the Voyage engine during content authoring.

Does the item schema support optional fields for in-game lore and descriptions?

Yes, the item schema supports optional fields for in-game lore and descriptions. It distinguishes between required fields for core functionality and optional fields for readable content, ensuring flexible yet compliant item creation.

Why do my custom game items fail validation during content authoring?

Game items fail validation when they do not conform to the strict item schema. Missing required fields, invalid bonus structures, or incorrect category definitions will trigger validation errors to prevent inconsistent data.

Can I use this item schema for both weapon bonuses and readable lore content?

Yes, you can use this item schema for both weapon bonuses and readable lore content. It provides clear rules for defining specific bonuses on weapons while supporting optional fields for in-game lore descriptions.