AI Assisted Speedruns — AI skill for Claude Code

ai-assisted-speedruns

A plugin framework and an open standard for **AI Assisted Speedruns**: an LLM agent plays a game through a small, hardened tool interface, every decision is logged on one timeline, the run is recorded, and the result is published in a form anyone can verify and compare.

Three kinds of plugins, one core:

Plugin	Role	First implementations
game	exposes one game as a controller object plus API documentation	Portal (via cozyblaze/portal-agent), Slay the Spire (via Communication Mod); Kerbal Space Program (kRPC) planned
runtime	starts the agent against the broker with a hardened config	Codex, Claude Code
recorder	records the run and reacts to run events	OBS (obs-websocket v5), source-demo (in-game demo via SPT), null
timer	speedrun timer on screen and splits	LiveSplit (LiveSplit Server)

The agent only ever sees three tools per game: `_documentation`, `_screenshot`, `_exec`. That shape, the broker, the process hardening and the log/export format come from [cozyblaze/portal-agent](https://github.com/cozyblaze/portal-agent) (MIT), which is credited as their origin and is not affiliated with this project.

Disclaimer: anti-cheat, bans, your own risk

This framework drives a game with injected tooling (for Portal: SourcePauseTool's DLL and an IPC patch, with the game started outside the normal launcher). Anti-cheat and monitoring systems such as VAC, EAC or BattlEye can treat that as cheating and **ban the account, possibly permanently**. Use it only with games and builds that have no anti-cheat and no online component, never with online or competitive games, and preferably with a separate offline copy of the game (Portal here runs from Source Unpack, not from the Steam install). Do your own research on the game's terms and anti-cheat before you connect anything, use common sense, and accept that everything you do with this repository is at your own risk: the