hastur-operation-plugin: Skill for Claude Code

Godot Screenshot

This skill captures screenshots from a running Godot editor or game instance and saves them as PNG files. It depends on the godot-remote-executor skill — load it first so you understand how to discover executors, authenticate, and execute GDScript code.

Prerequisites

Before using this skill, you must have:

1. godot-remote-executor skill loaded — understand the executor API, snippet mode, auth tokens, and error handling
2. Auth token and base URL — same credentials used by godot-remote-executor
3. At least one connected executor — editor for editor screenshots, game for game screenshots

How Viewport Capture Works

The Godot API for capturing screenshots relies on the viewport's texture. The correct approach is:

var tree = Engine.get_main_loop() as SceneTree
var img = tree.root.get_texture().get_image()

This grabs the root Viewport's texture, converts it to an Image, and then you can call img.save_png(path) to write it to disk.

Why tree.root and not get_viewport()? Because in snippet mode your code runs inside a RefCounted instance (not a Node). The get_viewport() convenience method only exists on Node — it is NOT available on RefCounted, EditorInterface, or other non-Node objects. Always use Engine.get_main_loop() to get the SceneTree, then access tree.root to get the root Viewport.

Similarly, EditorInterface does not have a get_viewport() method either. The universal approach that works in all contexts is Engine.get_main_loop().root.

Screenshot Workflows

Editor Screenshot

This captures the entire Godot editor window.

Preconditions: An editor executor (type: "editor") must be connected.

var tree = Engine.get_main_loop() as SceneTree
var img = tree.root.get_texture().get_image()

var dict = Time.get_datetime_dict_from_system()
var date_str = "%04d-%02d-%02d" % [dict["year"], dict["month"], dict["day"]]
var time_str = "%02d-%02d-%02d" % [dict["hour"], dict["minute"], dict["second"]]

var rel_path = ".temp/" + date_str + "-" + time_str + "-editor.png"
var abs_path = ProjectSettings.globalize_path("res://" + rel_path)

var dir_abs = ProjectSettings.globalize_path("res://.temp")
if not DirAccess.dir_exists_absolute(dir_abs):
	DirAccess.make_dir_recursive_absolute(dir_abs)

var err = img.save_png(abs_path)
executeContext.output("path", rel_path)
executeContext.output("result", "OK" if err == OK else "Error: " + str(err))