Godot Agent Skills
Reusable skills for AI agents working with Godot projects.
Maintained by 2177-AI-LAB.
Why This Repository Exists
AI coding agents can write code, inspect projects and help developers solve problems. However, their results depend heavily on the quality of their instructions, their understanding of the project and their ability to verify their own work.
This repository aims to provide reusable, structured and practical skills that help AI agents work more reliably with the Godot game engine.
Rather than relying on isolated prompts, each skill packages a specific workflow, technical guidance, references and verification procedures.
Our goal is to make AI-assisted Godot development more consistent, transparent and safe.
Our Approach
We believe that a useful agent skill should:
- Be reusable across different Godot projects.
- Inspect the actual project before making assumptions.
- Prefer documented engine features and verified settings.
- Avoid unnecessary or unrelated modifications.
- Preserve existing gameplay and project architecture.
- Make changes carefully and keep them reversible.
- Verify results and clearly report limitations.
Skills should provide guidance, not blindly impose a predefined solution.
Current Skills
godot-2d-display-adaptation
A general-purpose skill for inspecting, adapting and verifying Godot 4.x 2D projects across different screen sizes, resolutions, aspect ratios and orientations.
It covers viewport configuration, stretch modes, cameras, SubViewports, CanvasLayers, Control nodes and display verification.
The skill is designed to help agents understand the existing project before recommending or applying display changes.
Version: 1.0.0
Location: godot-2d-display-adaptation/
Origin and Acknowledgements
Our first skill originates from work published in the Hermes Agent project by Nous Research.
Original source:
https://github.com/NousResearch/hermes-agent
Original skill: godot-2d-aspect-adaptation
The original author attribution and MIT license are preserved.
For this repository, the original workflow was reviewed and generalized for use across different Godot 4.x projects. Project-specific assumptions and examples were removed, and additional general-purpose display configuration guidance was introduced.
We acknowledge the work of the Hermes Agent project and the Nous Research team as the foundation for this adaptation.
This repository is an independent project. It is not an official Hermes Agent, Nous Research or Godot project, and does not imply endorsement by those projects.
Project Philosophy
2177-AI-LAB explores practical ways to improve collaboration between human developers and AI agents.
We value:
- Open knowledge and reusable technical resources.
- Clear attribution and respect for original licenses.
- Practical experimentation and reproducible workflows.
- Human supervision and developer control.
- Honest reporting of what an agent has actually verified.
A skill should help an agent become more capable without making its behavior less understandable.
Repository Structure
Each skill has its own directory and includes its instructions, references and relevant documentation.
Godot-Skills/
├── README.md
└── godot-2d-display-adaptation/
├── SKILL.md
├── README.md
├── LICENSE
└── references/
└── godot-display.md
Additional Godot skills may be added as the collection grows.
Licensing and Attribution
Licensing is maintained at the individual skill level.
Please consult the LICENSE and attribution information included in each skill directory before reusing or redistributing its contents.
Original authors and projects must receive appropriate credit.
2177-AI-LAB — Building practical tools and knowledge for AI-assisted development.