A reference guide to Orkid’s entity-component-system architecture, a way to build applications from reusable objects, data parts, and processing systems.

Use it when working with Orkid entities, components, systems, archetypes, scenes, spawners, simulation, and Python or Lua bindings.

It helps an agent find the right files and explain how Orkid objects, scenes, simulation, physics, and scripting fit together.

How tweakoz/orkid configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to tweakoz/orkid. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/tweakoz/orkid/develop/.claude/skills/orkecs-core/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/tweakoz/orkid

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/tweakoz/orkid/orkecs-core.svg)](https://agentmods.dev/skills/tweakoz/orkid/orkecs-core)

Your own site

<a href="https://agentmods.dev/skills/tweakoz/orkid/orkecs-core"><img src="https://agentmods.dev/badge/skills/tweakoz/orkid/orkecs-core.svg" alt="Measured on agentmods" height="20"></a>

Per session 81 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 2,757 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00081	$0.02757
Opus 5	$0.00041	$0.01378
Sonnet 5	$0.00016	$0.00551
Haiku 4.5	$0.00008	$0.00276

Measured 4d ago against content hash 287de48f972d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

orkecs-core scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/orkecs-core/SKILL.md · 254 lines

How it starts

The opening of the file, as written. The whole thing — 254 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Orkid ECS Architecture Reference

When answering questions about the ECS system in orkid, consult the files below. All under ork.ecs/.

Key Files

Component	Header
Entity	`inc/ork/ecs/entity.h`
Component/ComponentData	`inc/ork/ecs/component.h`
System/SystemData	`inc/ork/ecs/system.h`
Archetype	`inc/ork/ecs/archetype.h`
ReferenceArchetype	`inc/ork/ecs/ReferenceArchetype.h`
SceneData	`inc/ork/ecs/scene.h`
SceneObject/SceneDagObject	`inc/ork/ecs/sceneobject.h`
Simulation	`inc/ork/ecs/simulation.h`
Controller	`inc/ork/ecs/controller.h`
SceneGraphComponent	`inc/ork/ecs/SceneGraphComponent.h`
Physics (Bullet)	`inc/ork/ecs/physics/bullet.h`
Python Scripts	`inc/ork/ecs/pysys/PythonComponent.h`
Lua Scripts	`inc/ork/ecs/lua/LuaComponent.h`
Types/Tokens	`inc/ork/ecs/types.h`
DataTable	`inc/ork/ecs/datatable.h`
EcsRuntime Helper	`obt.project/scripts/ork/hypergraph/ecs/runtime.py` (import: `from ork.hypergraph.ecs import EcsRuntime`)

Applications:

Program	Location	Purpose
`ork.ecsedit.py`	`obt.project/bin/ork.ecsedit.py`	Scene editor (edit/stage/play modes)
`ork.ecsplay.py`	`obt.project/bin/ork.ecsplay.py`	Scene player (stage then play)

Editor Implementation:

File	Purpose
`obt.project/scripts/ork/editor/ecsedit.py`	Full ECS editor: outliner, propsheet, 3D viewport, toolbar
`obt.project/scripts/ork/editor/ecs_outliner_model.py`	OutlinerModel for Archetypes/Spawners/Systems
`obt.project/scripts/ork/editor/scene_editor_base.py`	Base class for editor modes
`obt.project/scripts/ork/editor/scene_io.py`	Scene load/save via FilesystemBrowser
`obt.project/scripts/ork/editor/light_editor.py`	Light property editing
`obt.project/scripts/ork/editor/ptc_factories.py`	PropertySheet custom editor factories

Python Bindings: pyext/ directory:

pyext_controller.cpp, pyext_scene.cpp, pyext_entity.cpp
pyext_component.cpp, pyext_system.cpp, pyext_simulation.cpp
pyext_archetype.cpp, pyext_physics.cpp, pyext_scenegraph.cpp

Read the full file on GitHub · 254 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 254 lines · 81 tokens per session scan A 287de48f972d

Subscribe to this mod's changes

orkecs-core is a skill published in the GitHub repository tweakoz/orkid (35 stars, last pushed 24d ago), licensed MIT. It adds 81 tokens to every session and 2,757 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-01.

Game development audio ecs linux mac particles simulation

luban-dev

Luban 游戏配置全栈工具，支持枚举/Bean/数据表的增删改查、代码生成、TEngine 集成。触发场景：(1) 编辑游戏配置数据（配置表/数据表/道具表/技能表/奖励表/活动表），(2) 新增/修改/删除配置表结构，(3) 定义枚举/Bean/字段，(4) 导表/生成配置代码，(5) 编写 luban.conf 或 Schema 定义，(6) Luban 类型系统/校验器问题。即使用户未明确说"Luban"，只要是编辑游戏配置数据，也应使用此技能。.

Alex-Rachel/TEngine · 149 tokens

html-to-ugui

HTML 原型转 Unity UGUI 智能 Prefab 生成管线。通过 AI 生成符合 UI-DSL 的 HTML，用 Playwright/浏览器烘焙 JSON v2 坐标、图片和适配意图，再导入 Unity 由 HtmlToUGUIBaker 生成可维护、多终端适配的 UGUI Prefab。触发场景：(1) 需要从自然语言生成 Unity UGUI 界面 (2) 需要从 HTML 原型烘焙 UGUI (3) UI 中包含图片并希望一键导入/绑定 Sprite (4) 需要 PC/mobile/pad 多终端适配 Prefab。.

Alex-Rachel/TEngine · 150 tokens

metasounds

Create and modify MetaSound Source assets — add/connect nodes, wire pins, set input defaults, and play procedurally (MetaSoundService). Use when the user asks to create a MetaSound, build or edit a MetaSound graph, add operator/input/output nodes, or generate procedural audio.

kevinpbuckley/VibeUE · 63 tokens

tengine-dev

TEngine Unity 游戏框架开发指导。触发词：TEngine, UIWindow, UIWidget, GameEvent, AddUIEvent, LoadAssetAsync, SetSprite, HybridCLR, YooAsset, Luban, GameModule, 热更, 资源加载, UI开发, 事件系统, 配置表.

Alex-Rachel/TEngine · 68 tokens

et-unitybridge

UnityBridge workflow for AI operations in Unity Editor. Use when checking UnityBridge connectivity, Unity compile or PlayMode state, running deferred UnityBridge commands, operating assets/scenes/GameObjects/Inspector/Prefabs/GameView/screenshots, running Editor tests, or troubleshooting UnityBridge responses.

FlameskyDexive/Legends-Of-Heroes · 61 tokens

et-eui

ET EUI client UI workflow for this project's cn.etetet.eui framework. Use when creating or modifying DlgXxx windows, ESxxx reusable sub-UI, ItemXxx loop items, AUIEvent handlers, WindowID registration, widget binding (E via UIFindHelper), ShowWindow/Hide/Close flow, EUI root layers, or LoopScrollRect lists.…

FlameskyDexive/Legends-Of-Heroes · 98 tokens

orkid: Skill for Claude Code