[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CS2FAGPTJK6V0DXJRJC2F8":3,"skill-same:01M7CS2FAGPTJK6V0DXJRJC2F8":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M7CS2FAGPTJK6V0DXJRJC2F8","godot-csharp-and-gdextension",null,"Use when a Godot project uses or considers C# (.NET) or native code - when C# is the right call and its export limits (no web export), C# node patterns with generated SignalName\u002FStringName caching, plain C# rule libraries tested with dotnet test, and GDExtension (godot-cpp, godot-rust) pinning and build hygiene.","makifbaysal\u002Ftasktrooper","makifbaysal","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F25031940?v=4","01M7CRG3ZCSYZSSEVDMW3DEYC8","Mehmet Akif Baysal","01M7CRG401FJ8YAXH5ER730XYV",122,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fgame-developer\u002Fskills\u002Fgodot-csharp-and-gdextension\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: godot-csharp-and-gdextension\ncategory: architecture\ndescription: Use when a Godot project uses or considers C# (.NET) or native code - when C# is the right call and its export limits (no web export), C# node patterns with generated SignalName\u002FStringName caching, plain C# rule libraries tested with dotnet test, and GDExtension (godot-cpp, godot-rust) pinning and build hygiene.\ntech_stack: Godot\nsource: informed by the Godot 4 C#\u002F.NET and GDExtension documentation; own wording\n---\n# Godot C# and GDExtension\n\n## Overview\n\nGodot runs GDScript, C# (.NET) and native code through GDExtension (C++ via godot-cpp, Rust via godot-rust, and others). Each has a cost: C# needs the .NET build of the editor and cannot export to the web; GDExtension needs a native build per target platform. The repository's existing choice wins; adding a second language is a decision, not a convenience.\n\n**Core principle:** GDScript by default, C# where the project already is .NET or the team needs it and the web is not a target, GDExtension only for measured hot spots or native libraries.\n\n## When which\n\n| Need | Choice |\n|---|---|\n| Web export required | GDScript (C# web export is still unsupported in Godot 4.7) |\n| Team is C#, heavy algorithms, .NET libraries | C# — on desktop and mobile targets |\n| A measured hot loop GDScript cannot meet the budget with | GDExtension (C++ or Rust), or move it to C# if the project is .NET |\n| Binding an existing native SDK | GDExtension |\n\nMixing GDScript and C# in one project works (cross-language calls go through `Call`, `Get`, signals), but keep one language per feature and a clear boundary.\n\n## C# nodes\n\n```csharp\nusing Godot;\n\npublic partial class Player : CharacterBody2D\n{\n    [Signal] public delegate void HealthChangedEventHandler(int current, int maximum);\n\n    [Export] public PlayerDefinition Definition { get; set; }\n\n    static readonly StringName JumpAction = \"jump\";\n    static readonly StringName MoveLeft = \"move_left\";\n    static readonly StringName MoveRight = \"move_right\";\n\n    AnimatedSprite2D _sprite;\n    int _health;\n\n    public override void _Ready()\n    {\n        _sprite = GetNode\u003CAnimatedSprite2D>(\"AnimatedSprite2D\");\n        _health = Definition.MaxHealth;\n    }\n\n    public override void _PhysicsProcess(double delta)\n    {\n        var v = Velocity;\n        v.X = Input.GetAxis(MoveLeft, MoveRight) * Definition.MoveSpeed;\n        if (IsOnFloor() && Input.IsActionJustPressed(JumpAction)) v.Y = -Definition.JumpSpeed;\n        v.Y += Definition.Gravity * (float)delta;\n        Velocity = v;\n        MoveAndSlide();\n    }\n\n    public void TakeDamage(int amount)\n    {\n        _health = Mathf.Max(0, _health - amount);\n        EmitSignal(SignalName.HealthChanged, _health, Definition.MaxHealth);\n    }\n}\n```\n\n- Classes deriving from Godot types are `partial` (source generators fill in the rest); the file name matches the class name.\n- Use the generated `SignalName`, `PropertyName` and `MethodName` members instead of string literals.\n- **Cache `StringName`s.** Passing a C# `string` to `Input.IsActionPressed(\"jump\")` converts it to a `StringName` on every call — an allocation per frame per call.\n- Prefer .NET collections inside C# code; `Godot.Collections.Array`\u002F`Dictionary` marshal on every access and belong only at the engine boundary (exports, signals).\n- Cache node references in `_Ready`; never `GetNode` inside `_Process`.\n- `delta` is a `double` in Godot 4 C#.\n\n## Rules in a plain library\n\n```\nGame.Core\u002F          net8.0 class library — no Godot reference; rules, math, state machines\nGame.Core.Tests\u002F    xUnit or NUnit, references Game.Core\nGame\u002F               the Godot project (.csproj references Game.Core)\n```\n\n`dotnet test Game.Core.Tests` runs anywhere, with or without Godot installed (testable-game-logic). Engine-level C# tests go through gdUnit4Net (godot-testing).\n\n## GDExtension\n\n```ini\n; res:\u002F\u002Fbin\u002Fpathfinding.gdextension\n[configuration]\nentry_symbol = \"pathfinding_library_init\"\ncompatibility_minimum = \"4.7\"\n\n[libraries]\nmacos.debug = \"res:\u002F\u002Fbin\u002Flibpathfinding.macos.template_debug.framework\"\nmacos.release = \"res:\u002F\u002Fbin\u002Flibpathfinding.macos.template_release.framework\"\nlinux.debug.x86_64 = \"res:\u002F\u002Fbin\u002Flibpathfinding.linux.template_debug.x86_64.so\"\nwindows.debug.x86_64 = \"res:\u002F\u002Fbin\u002Fpathfinding.windows.template_debug.x86_64.dll\"\n```\n\n- **C++ (godot-cpp):** pin the godot-cpp branch\u002Ftag to the project's Godot minor; build with SCons (`scons platform=macos target=template_debug`) or the CMake setup the repository uses; register classes in the init function.\n- **Rust (godot-rust \u002F gdext):** pin the `godot` crate version and its API feature to the project's Godot minor; `cargo build`; `#[derive(GodotClass)]` types appear as nodes.\n- Commit the `.gdextension` file and the source; commit built binaries only if the repository already does (otherwise CI builds them).\n- Keep the native API small and coarse-grained: one call that processes a batch beats a thousand calls from GDScript per frame — crossing the boundary has a cost.\n- Unit-test the native core in its own language (C++ test runner, `cargo test`) without the engine; test the binding from GDScript with gdUnit4.\n\n## Export limits to state up front\n\n- C#: no web export in Godot 4.7; mobile exports are supported but check the pinned version's notes; the export template must be the .NET one.\n- GDExtension: one binary per platform and architecture; a missing entry in `[libraries]` means the feature silently fails on that platform — test the export for every target the task names, or say which you could not build.\n\n## Common Mistakes\n\n- Choosing C# for a game whose task lists the browser as a platform.\n- String literals for action names and signal names in hot C# paths.\n- Godot collections used for internal C# state.\n- A GDExtension built against a different Godot minor than the project, failing to load at runtime.\n- Calling into native code per entity per frame instead of per batch.\n\n## Red Flags\n\n- A new `.csproj` appearing in a GDScript-only project, or GDScript files appearing in a C#-only one, for a task that did not ask for it.\n- `GetNode` inside `_Process` \u002F `_PhysicsProcess`.\n- A `.gdextension` file with platforms listed whose binaries are not built anywhere.\n","# Godot C# and GDExtension\n\n## Overview\n\nGodot runs GDScript, C# (.NET) and native code through GDExtension (C++ via godot-cpp, Rust via godot-rust, and others). Each has a cost: C# needs the .NET build of the editor and cannot export to the web; GDExtension needs a native build per target platform. The repository's existing choice wins; adding a second language is a decision, not a convenience.\n\n**Core principle:** GDScript by default, C# where the project already is .NET or the team needs it and the web is not a target, GDExtension only for measured hot spots or native libraries.\n\n## When which\n\n| Need | Choice |\n|---|---|\n| Web export required | GDScript (C# web export is still unsupported in Godot 4.7) |\n| Team is C#, heavy algorithms, .NET libraries | C# — on desktop and mobile targets |\n| A measured hot loop GDScript cannot meet the budget with | GDExtension (C++ or Rust), or move it to C# if the project is .NET |\n| Binding an existing native SDK | GDExtension |\n\nMixing GDScript and C# in one project works (cross-language calls go through `Call`, `Get`, signals), but keep one language per feature and a clear boundary.\n\n## C# nodes\n\n```csharp\nusing Godot;\n\npublic partial class Player : CharacterBody2D\n{\n    [Signal] public delegate void HealthChangedEventHandler(int current, int maximum);\n\n    [Export] public PlayerDefinition Definition { get; set; }\n\n    static readonly StringName JumpAction = \"jump\";\n    static readonly StringName MoveLeft = \"move_left\";\n    static readonly StringName MoveRight = \"move_right\";\n\n    AnimatedSprite2D _sprite;\n    int _health;\n\n    public override void _Ready()\n    {\n        _sprite = GetNode\u003CAnimatedSprite2D>(\"AnimatedSprite2D\");\n        _health = Definition.MaxHealth;\n    }\n\n    public override void _PhysicsProcess(double delta)\n    {\n        var v = Velocity;\n        v.X = Input.GetAxis(MoveLeft, MoveRight) * Definition.MoveSpeed;\n        if (IsOnFloor() && Input.IsActionJustPressed(JumpAction)) v.Y = -Definition.JumpSpeed;\n        v.Y += Definition.Gravity * (float)delta;\n        Velocity = v;\n        MoveAndSlide();\n    }\n\n    public void TakeDamage(int amount)\n    {\n        _health = Mathf.Max(0, _health - amount);\n        EmitSignal(SignalName.HealthChanged, _health, Definition.MaxHealth);\n    }\n}\n```\n\n- Classes deriving from Godot types are `partial` (source generators fill in the rest); the file name matches the class name.\n- Use the generated `SignalName`, `PropertyName` and `MethodName` members instead of string literals.\n- **Cache `StringName`s.** Passing a C# `string` to `Input.IsActionPressed(\"jump\")` converts it to a `StringName` on every call — an allocation per frame per call.\n- Prefer .NET collections inside C# code; `Godot.Collections.Array`\u002F`Dictionary` marshal on every access and belong only at the engine boundary (exports, signals).\n- Cache node references in `_Ready`; never `GetNode` inside `_Process`.\n- `delta` is a `double` in Godot 4 C#.\n\n## Rules in a plain library\n\n```\nGame.Core\u002F          net8.0 class library — no Godot reference; rules, math, state machines\nGame.Core.Tests\u002F    xUnit or NUnit, references Game.Core\nGame\u002F               the Godot project (.csproj references Game.Core)\n```\n\n`dotnet test Game.Core.Tests` runs anywhere, with or without Godot installed (testable-game-logic). Engine-level C# tests go through gdUnit4Net (godot-testing).\n\n## GDExtension\n\n```ini\n; res:\u002F\u002Fbin\u002Fpathfinding.gdextension\n[configuration]\nentry_symbol = \"pathfinding_library_init\"\ncompatibility_minimum = \"4.7\"\n\n[libraries]\nmacos.debug = \"res:\u002F\u002Fbin\u002Flibpathfinding.macos.template_debug.framework\"\nmacos.release = \"res:\u002F\u002Fbin\u002Flibpathfinding.macos.template_release.framework\"\nlinux.debug.x86_64 = \"res:\u002F\u002Fbin\u002Flibpathfinding.linux.template_debug.x86_64.so\"\nwindows.debug.x86_64 = \"res:\u002F\u002Fbin\u002Fpathfinding.windows.template_debug.x86_64.dll\"\n```\n\n- **C++ (godot-cpp):** pin the godot-cpp branch\u002Ftag to the project's Godot minor; build with SCons (`scons platform=macos target=template_debug`) or the CMake setup the repository uses; register classes in the init function.\n- **Rust (godot-rust \u002F gdext):** pin the `godot` crate version and its API feature to the project's Godot minor; `cargo build`; `#[derive(GodotClass)]` types appear as nodes.\n- Commit the `.gdextension` file and the source; commit built binaries only if the repository already does (otherwise CI builds them).\n- Keep the native API small and coarse-grained: one call that processes a batch beats a thousand calls from GDScript per frame — crossing the boundary has a cost.\n- Unit-test the native core in its own language (C++ test runner, `cargo test`) without the engine; test the binding from GDScript with gdUnit4.\n\n## Export limits to state up front\n\n- C#: no web export in Godot 4.7; mobile exports are supported but check the pinned version's notes; the export template must be the .NET one.\n- GDExtension: one binary per platform and architecture; a missing entry in `[libraries]` means the feature silently fails on that platform — test the export for every target the task names, or say which you could not build.\n\n## Common Mistakes\n\n- Choosing C# for a game whose task lists the browser as a platform.\n- String literals for action names and signal names in hot C# paths.\n- Godot collections used for internal C# state.\n- A GDExtension built against a different Godot minor than the project, failing to load at runtime.\n- Calling into native code per entity per frame instead of per batch.\n\n## Red Flags\n\n- A new `.csproj` appearing in a GDScript-only project, or GDScript files appearing in a C#-only one, for a task that did not ask for it.\n- `GetNode` inside `_Process` \u002F `_PhysicsProcess`.\n- A `.gdextension` file with platforms listed whose binaries are not built anywhere.\n",{"name":5,"source":24,"category":25,"tech_stack":26,"description":7},"informed by the Godot 4 C#\u002F.NET and GDExtension documentation; own wording","architecture","Godot","main","910394a0b6db9fc8c9a8f36328ec421d3ebd8b38","catalog\u002Fagents\u002Fgame-developer\u002Fskills\u002Fgodot-csharp-and-gdextension",18,"https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper","https:\u002F\u002Ftasktrooper.ai","https:\u002F\u002Fgithub.com\u002Fmakifbaysal","Senior Software Developer","2026-11-15 04:50:29",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add makifbaysal\u002Ftasktrooper --skill godot-csharp-and-gdextension",{"tool":42,"command":43},"bunx","bunx skills add makifbaysal\u002Ftasktrooper --skill godot-csharp-and-gdextension",{"tool":45,"command":46},"pnpm","pnpm dlx skills add makifbaysal\u002Ftasktrooper --skill godot-csharp-and-gdextension","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fgame-developer\u002Fskills\u002Fgodot-csharp-and-gdextension\u002FSKILL.md",true,[],[51,57,64,71,78,85],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7CSVEPQW6J6TD6CS2T5FPNZ","visual-craft","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fui-designer\u002Fskills\u002Fvisual-craft\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7CSVAQG91ETHQ0HBNZDG5FR","ux-copy","Use when you write any words a user reads in a mockup or a hand-off - content language and voice, buttons, labels, errors, empty states, confirmations, numbers and dates, and the longest-string check","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fui-designer\u002Fskills\u002Fux-copy\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7CSV6H0J38659NDXHJQ8396","screen-mockup-html","Use when you draw screens as the design task's HTML mockup - ONE canvas document holding every screen and every variant side by side, the sanitizer-safe recipe, phone and wide frames, the states grid, static control states, and the loopback self-check with screenshots at 375, 768 and 1440 attached to the task","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fui-designer\u002Fskills\u002Fscreen-mockup-html\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7CSV3JFRF3BM3XK52M7YEYR","performance-awareness","How the performance score moves for your role. Use when the score context shows a declining trend, or before handing off work you have not self-checked against every criterion.","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fui-designer\u002Fskills\u002Fperformance-awareness\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7CSTZDH00YRF5SCT7BRT9QD","design-variants","Use when a screen design needs variants - how many, variants as side-by-side rows on the one canvas, what makes two variants genuinely different, recommending one, how the human's choice is read, and narrowing to the chosen one in revision","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fui-designer\u002Fskills\u002Fdesign-variants\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7CSTV6P3SM3PAE28DB0RF77","design-system-authoring","Use when you derive, change or extend a design system - where tokens live per stack, the DTCG token tree, role-based names for both themes, base vs layer vs drift, the DESIGN.md section order, the inventory format, the contrast check and the lint every proposal returns","https:\u002F\u002Fgithub.com\u002Fmakifbaysal\u002Ftasktrooper\u002Fblob\u002Fmain\u002Fcatalog\u002Fagents\u002Fui-designer\u002Fskills\u002Fdesign-system-authoring\u002FSKILL.md",[],[]]