2177-AI-LAB commited on
Commit
d2ddf54
Β·
verified Β·
1 Parent(s): ad7c38f

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +113 -0
README.md ADDED
@@ -0,0 +1,113 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ tags:
3
+ - godot
4
+ - ai-agent-skills
5
+ - agent-skills
6
+ - game-development
7
+ - hermes-agent
8
+ ---
9
+
10
+ # Godot Agent Skills
11
+
12
+ **Reusable skills for AI agents working with Godot projects.**
13
+
14
+ Maintained by **2177-AI-LAB**.
15
+
16
+ ## Why This Repository Exists
17
+
18
+ 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.
19
+
20
+ This repository aims to provide reusable, structured and practical skills that help AI agents work more reliably with the Godot game engine.
21
+
22
+ Rather than relying on isolated prompts, each skill packages a specific workflow, technical guidance, references and verification procedures.
23
+
24
+ Our goal is to make AI-assisted Godot development more consistent, transparent and safe.
25
+
26
+ ## Our Approach
27
+
28
+ We believe that a useful agent skill should:
29
+
30
+ - Be reusable across different Godot projects.
31
+ - Inspect the actual project before making assumptions.
32
+ - Prefer documented engine features and verified settings.
33
+ - Avoid unnecessary or unrelated modifications.
34
+ - Preserve existing gameplay and project architecture.
35
+ - Make changes carefully and keep them reversible.
36
+ - Verify results and clearly report limitations.
37
+
38
+ Skills should provide guidance, not blindly impose a predefined solution.
39
+
40
+ ## Current Skills
41
+
42
+ ### godot-2d-display-adaptation
43
+
44
+ A general-purpose skill for inspecting, adapting and verifying Godot 4.x 2D projects across different screen sizes, resolutions, aspect ratios and orientations.
45
+
46
+ It covers viewport configuration, stretch modes, cameras, SubViewports, CanvasLayers, Control nodes and display verification.
47
+
48
+ The skill is designed to help agents understand the existing project before recommending or applying display changes.
49
+
50
+ **Version:** 1.0.0
51
+
52
+ **Location:** `godot-2d-display-adaptation/`
53
+
54
+ ## Origin and Acknowledgements
55
+
56
+ Our first skill originates from work published in the **Hermes Agent** project by Nous Research.
57
+
58
+ Original source:
59
+
60
+ https://github.com/NousResearch/hermes-agent
61
+
62
+ Original skill: `godot-2d-aspect-adaptation`
63
+
64
+ The original author attribution and MIT license are preserved.
65
+
66
+ 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.
67
+
68
+ We acknowledge the work of the Hermes Agent project and the Nous Research team as the foundation for this adaptation.
69
+
70
+ 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.
71
+
72
+ ## Project Philosophy
73
+
74
+ 2177-AI-LAB explores practical ways to improve collaboration between human developers and AI agents.
75
+
76
+ We value:
77
+
78
+ - Open knowledge and reusable technical resources.
79
+ - Clear attribution and respect for original licenses.
80
+ - Practical experimentation and reproducible workflows.
81
+ - Human supervision and developer control.
82
+ - Honest reporting of what an agent has actually verified.
83
+
84
+ A skill should help an agent become more capable without making its behavior less understandable.
85
+
86
+ ## Repository Structure
87
+
88
+ Each skill has its own directory and includes its instructions, references and relevant documentation.
89
+
90
+ ```text
91
+ Godot-Skills/
92
+ β”œβ”€β”€ README.md
93
+ └── godot-2d-display-adaptation/
94
+ β”œβ”€β”€ SKILL.md
95
+ β”œβ”€β”€ README.md
96
+ β”œβ”€β”€ LICENSE
97
+ └── references/
98
+ └── godot-display.md
99
+ ```
100
+
101
+ Additional Godot skills may be added as the collection grows.
102
+
103
+ ## Licensing and Attribution
104
+
105
+ Licensing is maintained at the individual skill level.
106
+
107
+ Please consult the `LICENSE` and attribution information included in each skill directory before reusing or redistributing its contents.
108
+
109
+ Original authors and projects must receive appropriate credit.
110
+
111
+ ---
112
+
113
+ **2177-AI-LAB β€” Building practical tools and knowledge for AI-assisted development.**