IrredenEngine: Skill for Claude Code

Create a New Creation

A creation is an executable linking the engine, under creations/<category>/ (demos/, editors/, hana_class_projects/, or the private game/ path). Minimum file sets, visibility tiers, and the asset-staging rule: creations/CLAUDE.md; demo conventions: creations/demos/CLAUDE.md §"Adding a new demo". References: creations/demos/shape_debug/CMakeLists.txt (canonical CMake), creations/demos/default/main.cpp (C++-only), creations/demos/default/main_lua.cpp plus its binding files (Lua).

1. CMakeLists.txt

Replace YourCreation / YOUR_CREATION with the real name — they are scaffold sentinels that simplify flags if they survive into source:

set(IR_YOUR_CREATION_RUNTIME_DIR ${CMAKE_CURRENT_BINARY_DIR})
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${IR_YOUR_CREATION_RUNTIME_DIR})
add_executable(IRYourCreation main.cpp)
target_link_libraries(IRYourCreation PUBLIC IrredenEngine)

# Exe-relative data/ shaders/ scripts/ (+ Windows DLLs) and the
# IRYourCreationPackage bundle target. Never hand-roll an *Assets target.
irreden_bundle_assets(IRYourCreation SCRIPTS config.lua)
irreden_package_target(IRYourCreation)

add_custom_target(IRYourCreationRun
    COMMAND $<TARGET_FILE:IRYourCreation>
    DEPENDS IRYourCreation IRYourCreationAssets
    WORKING_DIRECTORY ${IR_YOUR_CREATION_RUNTIME_DIR}
    USES_TERMINAL
)

A Lua creation lists every script in SCRIPTS (main.lua config.lua ..., as in creations/demos/default/CMakeLists.txt); Lua-defined components or systems add irreden_lua_codegen(...) (lua-creation-setup skill).

2. Register

Create creation.json beside the CMake file. It uses the v1 schema in docs/design/engine-launcher.md §D2 and lists the runnable target plus an Interactive preset.

• Engine-owned: append add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/<category>/<name>) to creations/CMakeLists.txt — append, never reorder.
• Private game: place it in creations/game/; the root CMakeLists.txt auto-adds it when creations/game/CMakeLists.txt exists.