RandallLiuXin/GodotMaker / skills/core/gecs
gecs
Verifiedgecs ECS framework API reference — the Entity-Component-System addon for Godot 4.x used by this project. Covers Entity, Component, System, World, QueryBuilder, Relationship, Observer, CommandBuffer, SystemTimer. Use when the task involves ECS architecture: creating entities with components, defining component data classes (C_ prefix), writing game logic systems, querying entities by component composition, entity relationships or links, reactive observers for component changes, safe structural changes during iteration, system tick rates, ECS world setup, debugging ECS queries or cache, or deferred entity destruction. Also trigger on gecs API calls: q.with_all(), ECS.world, ECS.process(), define_components(), cmd.add_component(). gecs has zero LLM training data — without this skill all ECS API calls will be fabricated. NOT relevant for standard Godot subsystems (physics, animation, UI, tilemap, shader, particles, navigation, signals, audio) unless explicitly connected to ECS.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.8 KB |
| evals/evals.json | config | 3.5 KB |
| gotchas-examples.md | markdown | 7.3 KB |
| gotchas.md | markdown | 4.0 KB |
| references/component.md | markdown | 5.6 KB |
| references/debug.md | markdown | 7.0 KB |
| references/entity.md | markdown | 9.2 KB |
| references/patterns.md | markdown | 12.3 KB |
| references/query.md | markdown | 12.5 KB |
| references/system.md | markdown | 13.0 KB |
| references/world.md | markdown | 8.8 KB |
evals/evals.json
View on GitHub{
"skill_name": "gecs",
"evals": [
{
"id": 0,
"prompt": "Create a player entity with Health, Position, and Velocity components using gecs. Write the component files and entity file as complete GDScript. The player should have 100 max health, start at position (0, 0, 0), and have zero initial velocity.",
"expected_output": "GDScript files: C_Health, C_Position, C_Velocity components extending Component with @export properties, and a Player entity extending Entity with define_components()",
"files": [],
"assertions": [
"Entity class extends Entity (not Node, Node2D, or CharacterBody)",
"All component classes extend Component (which extends Resource)",
"Component class names use C_ prefix (C_Health, C_Position, C_Velocity)",
"All @export properties have default values",
"Entity uses define_components() returning .new() instances",
"No game logic in component classes (pure data)"
]
},
{
"id": 1,
"prompt": "Write a movement system in gecs that processes all entities with Position and Velocity components. The system should update position based on velocity each frame. Write the complete GDScript file.",
"expected_output": "A System class with query() using with_all and process() that updates position from velocity",
"files": [],
"assertions": [
"System class extends System (not Node)",
"Has query() method returning QueryBuilder (using q.with_all)",
"query() uses with_all([C_Position, C_Velocity]) or similar correct syntax",
"Has process() with correct signature (entities: Array[Entity], components: Array, delta: float)",
"Accesses components via entity.get_component(C_ClassName) passing the class",
"Updates position using delta for frame-independent movement"
]
},
{
"id": 2,
"prompt": "How do I inspect entities at runtime using gecs debug tools? I want to see what components an entity has, monitor system performance, and check query cache efficiency.",
"expected_output": "Explanation of gecs debug mode, editor debugger, lastRunData, cache stats, and how to enable them",
"files": [],
"assertions": [
"Mentions enabling debug mode via ECS.debug or project settings (gecs/settings/debug_mode)",
"Mentions the editor debugger plugin or debug tab",
"Mentions lastRunData for system performance monitoring",
"Mentions get_cache_stats() for query cache efficiency",
"Does NOT give generic Godot debugging advice as if gecs debug tools don't exist"
]
},
{
"id": 3,
"prompt": "Set up a complete gecs World with a player entity, 3 enemy entities, and a movement system. Show the main scene script that processes systems by group, and the scene tree structure. Write all files as complete GDScript.",
"expected_output": "World setup with ECS.world assignment, entity creation, system registration, grouped processing in _process/_physics_process",
"files": [],
"assertions": [
"Sets ECS.world = world (or $World) in _ready()",
"Uses ECS.process(delta, group_name) pattern for system processing",
"Creates entities via Entity.new() or scene instantiation, then ECS.world.add_entity()",
"System groups are organized (e.g. gameplay, physics, or similar grouping)",
"Shows or describes the scene tree structure with World and SystemGroup nodes",
"Enemy entities are created in a loop or individually with correct gecs API"
]
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |