Official agent skill

Gdextension Hygiene

by microsoft in microsoft/XBOX-Godot-Sample

Run a Godot/GDExtension finish pass over the current diff: enforce headless GDScript validation, public API docclasses coverage, docs/spec/sample/test synchronization, and registration or CMake…

OfficialMITAuto-check passedGame Development

Install Gdextension Hygiene

skills CLI
$ npx skills add microsoft/XBOX-Godot-Sample --skill gdextension-hygiene -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/XBOX-Godot-Sample gdextension-hygiene --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/XBOX-Godot-Sample.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/gdextension-hygiene .claude/skills/gdextension-hygiene && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gdextension-hygiene
GitHub stars
237
Token cost
~983 tokens
SKILL.md length
454 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Run a Godot/GDExtension finish pass over the current diff: enforce headless GDScript validation, public API docclasses coverage, docs/spec/sample/test synchronization, and registration or CMake…

  • Works in 5 steps: Identify the changed surfaces in the diff. → Build the minimum finish-pass checklist… → Fix the missing follow-through directly… → …
  • Tasks that involve Game development
  • SKILL.md covers Core rules, Finish-pass checklist, Workflow and Output format
  • Calls pwsh

What it does

Gdextension Hygiene is an agent skill from microsoft/XBOX-Godot-Sample, published by the product's own GitHub organization. Run a Godot/GDExtension finish pass over the current diff: enforce headless GDScript validation, public API docclasses coverage, docs/spec/sample/test synchronization, and registration or CMake follow-through. Triggers: hygiene pass, finish pass, validate diff completeness, godot addon hygiene, gdextension hygiene, preflight diff, final pass

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Game development and Technical documentation. It works with Godot and C++. The repository describes itself as: An example implementation binding the Microsoft GDK, XBOX Services, PlayFab and GameInput to Godot 4. Provides GDExtension and Game references for shipping on XBOX on PC. The licence is MIT.

When your agent uses it

  • Tasks that involve Game development
  • Tasks that involve Technical documentation

Example prompts

  • “/gdextension-hygiene”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify the changed surfaces in the diff.
  2. Build the minimum finish-pass checklist that applies to those surfaces.
  3. Fix the missing follow-through directly when it is concrete and local.
  4. Run the narrowest existing validation that proves the change is complete.
  5. Report any remaining gaps that need a product or scope decision.

What it can do on your machine

Read from SKILL.md and the folder at commit 3521140. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pwsh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gdextension Hygiene loads about 983 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 454 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~983

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/XBOX-Godot-Sample at commit 3521140, republished under its MIT licence (© microsoft). 454 words, ~983 tokens.

Download SKILL.mdSave it as .claude/skills/gdextension-hygiene/SKILL.md (or your agent's skills folder).
name
gdextension-hygiene
description
Run a Godot/GDExtension finish pass over the current diff: enforce headless GDScript validation, public API doc_classes coverage, docs/spec/sample/test synchronization, and registration or CMake follow-through. Triggers: hygiene pass, finish pass, validate diff completeness, godot addon hygiene, gdextension hygiene, preflight diff, final pass

GDExtension Hygiene Skill

You are the repo-local gdextension-hygiene skill. Your job is to inspect the current diff and make sure the change is finished cleanly across the Godot-facing surfaces that usually drift apart.

Core rules

  • Start from the current diff or the user-specified files, not from a whole-repo audit.
  • Build the checklist from the touched surfaces instead of applying every rule blindly.
  • Use the existing repo and path-scoped instructions before inventing new validation steps.
  • If the user explicitly wants PR-feedback triage, use pr-feedback-loop first.
  • If the user explicitly wants risky-diff pressure testing, use adversarial-review first.

Finish-pass checklist

  • For .gd changes anywhere in the repo, run:
powershell
pwsh -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\tools\check_gd_scripts_headless.ps1
  • For godot_gdk public contract changes:
    • ensure public classes, methods, properties, signals, and enums stay reflected in addons\godot_gdk\doc_classes\*.xml
    • ensure the related docs\<addon>\*.md, spec\gdext-<addon>.md, sample content, and tests stay aligned when behavior or script-visible API changes
  • For new native classes or source files:
    • ensure registration and ownership are wired correctly
    • ensure the relevant addon CMakeLists.txt includes the new files
  • For synced godot_gdk addon content under addons\godot_gdk\:
    • run the existing debug build step that refreshes the sample copy when required by the path-scoped instructions
  • For other addons:
    • follow their current build and documentation patterns
    • do not invent doc_classes requirements for addons that do not currently ship them
  • For tutorial / sample snippet drift (the hand-discipline backstop — there is no machine validator that holds tutorial prose and sample scripts in lockstep):
    • If any docs\tutorials\**\*.md was edited in this diff, verify the matching scene or script under the relevant sample\tutorial_gdk\, sample\tutorial_playfab\, sample\tutorial_integrated\ (or sample\tutorial_gameinput\ for the standalone GameInput track) was also touched in the same diff. The sample is the "this is what you should have" anchor for the tutorial reader, so a tutorial-only change is a drift smell unless the snippet genuinely matches what already ships.
    • If any script under sample\tutorial_gdk\, sample\tutorial_playfab\, sample\tutorial_integrated\, or sample\tutorial_gameinput\ was edited in this diff, verify the matching docs\tutorials\**\*.md was also touched. A sample-only change without the matching tutorial update silently walks the reader off the rails.
    • If the change is intentionally docs-only or sample-only (typo fix, comment polish, scene-tree node order that does not appear in any snippet, autoload refactor that does not change the snippet shape), call it out explicitly in the report so the reviewer can confirm the asymmetry is on purpose.
Show full SKILL.md (74 more words)Show less

Workflow

  1. Identify the changed surfaces in the diff.
  2. Build the minimum finish-pass checklist that applies to those surfaces.
  3. Fix the missing follow-through directly when it is concrete and local.
  4. Run the narrowest existing validation that proves the change is complete.
  5. Report any remaining gaps that need a product or scope decision.

Output format

Use this structure:

  1. Scope
  2. Required follow-through
  3. Gaps fixed
  4. Remaining gaps
  5. Validation

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/gdextension-hygiene of microsoft/XBOX-Godot-Sample.

Open the folder on GitHubat commit 3521140

Compare with similar skills

Gdextension Hygiene next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gdextension Hygiene compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gdextension Hygiene this skillmicrosoft/XBOX-Godot-Sample237—~983Automated safety check: PassMIT
Beehavejame581/GodotPrompter795—~2.8kAutomated safety check: PassMIT
Headless BuildRandallLiuXin/GodotMaker5491 repos~454Automated safety check: PassCustom licence
Gdextensionjame581/GodotPrompter795—~2.7kAutomated safety check: PassMIT
Limboaijame581/GodotPrompter795—~3.2kAutomated safety check: PassMIT
Defold API Fetchselimanac/defold-astar111—~2.5kAutomated safety check: PassNone

Similar skills

  • Beehave

    jame581/GodotPrompter

    A skill your agent uses when using the Beehave addon — pure-GDScript behavior trees with composites, decorators, leaves, a blackboard, and a visual runtime debugger

    795 GitHub stars~2.8k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Headless Build

    RandallLiuXin/GodotMaker

    Compile-check a Godot project using headless mode. An agent skill from RandallLiuXin/GodotMaker.

    549 GitHub starsUsed in 1 repo~454 tokens
    Game DevelopmentAuto-check passed
  • Gdextension

    jame581/GodotPrompter

    A skill your agent uses when building native extensions for Godot — godot-cpp (C++) or gdext (Rust), binding classes, building, and GDScript/C interop

    795 GitHub stars~2.7k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Limboai

    jame581/GodotPrompter

    A skill your agent uses when using the LimboAI addon — behavior trees and hierarchical state machines (C++ GDExtension) with a visual editor, BTTask subclassing, and a blackboard

    795 GitHub stars~3.2k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Defold API Fetch

    selimanac/defold-astar

    Fetches Defold API documentation. An agent skill from selimanac/defold-astar.

    111 GitHub stars~2.5k tokensUpdated 5 mo ago
    Game DevelopmentAuto-check passed
  • Unreal Development

    CoWork-OS/CoWork-OS

    Unreal Engine development: C++/Blueprint patterns, Gameplay Framework, Niagara, Lumen/Nanite, multiplayer, and packaging.

    473 GitHub stars~446 tokensUpdated today
    Game DevelopmentAuto-check passed

More from microsoft/XBOX-Godot-Sample

  • Issue Triage

    microsoft/XBOX-Godot-Sample

    Official

    First-pass evaluation of a GitHub issue against this repository's code: classify it, find the relevant code, reason about likely causes or fit, flag version differences and missing information, and…

    237 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • PR Feedback Loop

    microsoft/XBOX-Godot-Sample

    Official

    Turn GitHub PR feedback into a disciplined remediation loop: gather review threads, comments, and check runs; classify actionable items; fix the concrete must-fix issues; run the right local…

    237 GitHub stars~716 tokensUpdated today
    Auto-check passed

Works with

Questions about Gdextension Hygiene

What does Gdextension Hygiene do?

Run a Godot/GDExtension finish pass over the current diff: enforce headless GDScript validation, public API docclasses coverage, docs/spec/sample/test synchronization, and registration or CMake…. Gdextension Hygiene is an agent skill from microsoft/XBOX-Godot-Sample, published by the product's own GitHub organization. Run a Godot/GDExtension finish pass over the current diff: enforce headless GDScript validation, public API docclasses coverage, docs/spec/sample/test synchronization, and registration or CMake follow-through.

When should I use Gdextension Hygiene?

Gdextension Hygiene fits situations like: tasks that involve Game development; tasks that involve Technical documentation.

How do I install Gdextension Hygiene in Claude Code?

Run `npx skills add microsoft/XBOX-Godot-Sample --skill gdextension-hygiene -a claude-code`. Or copy the skill folder (.github/skills/gdextension-hygiene in microsoft/XBOX-Godot-Sample) into .claude/skills/gdextension-hygiene in your project. Claude Code loads it when a task matches its description.

How do I install Gdextension Hygiene in Codex?

Run `npx skills add microsoft/XBOX-Godot-Sample --skill gdextension-hygiene -a codex`. Or copy the skill folder (.github/skills/gdextension-hygiene in microsoft/XBOX-Godot-Sample) into .agents/skills/gdextension-hygiene in your project. Codex loads it when a task matches its description.

Can I use Gdextension Hygiene in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/XBOX-Godot-Sample --skill gdextension-hygiene -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gdextension-hygiene, .gemini/skills/gdextension-hygiene, .github/skills/gdextension-hygiene and .opencode/skills/gdextension-hygiene in your project.

What does Gdextension Hygiene need to run?

Going by SKILL.md and its folder, Gdextension Hygiene needs the command-line tools its instructions call (pwsh).

Does Gdextension Hygiene access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gdextension Hygiene safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gdextension Hygiene use?

Gdextension Hygiene is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gdextension Hygiene use?

About 983 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gdextension Hygiene?

Skills that share tags, products or a category with Gdextension Hygiene: Beehave (jame581/GodotPrompter, 795 stars), Headless Build (RandallLiuXin/GodotMaker, 549 stars), Gdextension (jame581/GodotPrompter, 795 stars) and Limboai (jame581/GodotPrompter, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gdextension Hygiene?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/XBOX-Godot-Sample, which has 237 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/XBOX-Godot-Sample on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.