简体中文

CC: Tweaked LLM Skill

An Agent Skill that helps Claude and other LLMs write, review, and debug Minecraft CC: Tweaked (ComputerCraft) Lua programs correctly.

CC: Tweaked is the modern fork of ComputerCraft: programmable computers, turtles, and peripherals inside Minecraft. Its Lua environment is not desktop Lua: it runs on Cobalt (Lua 5.2), is driven by events and yielding, addresses peripherals by side or network name, and makes turtles burn fuel. Models that rely on old tutorials or memory invent functions, mix up : and ., lose events, or write Lua 5.3 syntax that does not compile.

This repository turns the execution model, APIs, peripherals, turtles, networking, design patterns, and troubleshooting into guidance an agent can follow. Core API contracts come from tweaked.cc; the user’s installed mods, server configuration, and effective recipes decide how that guidance applies.

Design philosophy: break the task down, agree on the goal, then write code. The skill steers the agent toward the simplest solution that works, from existing game mechanics and ROM programs to a short script or a full application. It reuses what the user already said, implements explicit requests directly, and asks only when a missing fact would change the design. Interfaces, logging frameworks, and authentication are added only when the task needs them.

Teach the reasoning, not just the answer. The skill explains constraints, structure choices, failure modes, and composable patterns: a responsive input listener beside yielding workers, bounded queues, checking that an action actually happened, recipe profiles, and reconciliation after a restart. Every example states where it stops applying; a familiar recipe or one passing test is never treated as a rule for every installation.

[!IMPORTANT] AI production disclosure: CC: Tweaked LLM Skill uses generative AI to assist with content creation, code validation, and documentation. AI-generated or modified content is reviewed and verified by the project maintainer, who retains final responsibility for its maintenance.

Current release: v1.3.1 (2026-10). A documentation-quality release: SKILL.md is reorganized and the concrete CC:T guidance lost in the v1.3.0 rewrite is restored, and all 26 references, both READMEs, and the installation guide are rewritten in clear language. See the release notes (中文).

---

What it can do

A delivered answer explains the approach, the devices and names it needs, the code, how to install and run it, and how it was verified. Detail scales with the task: a small fix does not get an application framework.

Skill contents

The skill uses progressive loading. SKILL.md (204 lines) holds the workflow, rules, execution model, quick reference, common mistakes, delivery format, reference map, and delivery checklist. The agent reads the 26 topic references only when a task needs them. Create and Advanced Peripherals contracts are kept apart from core CC:T and tied to the specific jars that were reviewed.

The references cover APIs, peripherals, events, state and recovery, recipes, turtles, networking, UI and text encoding, application engineering, security, patterns, testing, and troubleshooting. The mod guides describe Create 6.0.10 and Advanced Peripherals 1.21.1-0.8.2a on Minecraft 1.21.1 / NeoForge. Optional integrations (AE2, Refined Storage, Mekanism, and others) need those mods installed.

See the contents overview and the full reference map. Historical source material is kept in archive/, outside the installed skill and the prompt pack.

Installation

The skill follows the open Agent Skills format. Install the whole skills/minecraft-cc-tweaked/ folder, including references/, into your client’s skill directory. In Claude Code:

/plugin marketplace add EvergardenRoxy/CC-Tweaked_LLM_skill
/plugin install minecraft-cc-tweaked@cct-llm-skills

For clients that import an archive, download CCT_prompt_pack.zip; its root contains SKILL.md and references/. Check it against the release’s SHA256SUMS.

Installation and upgrades covers directory and archive installs, including Codex. Paths and support differ between clients; follow your client’s documentation. Upgrade by replacing the whole folder so old and new references are never mixed.

Usage

After installation, ask your agent to use the skill for CC:T work; whether it is picked up automatically depends on the client. Where relevant, provide:

• The CC:T version (run print(_HOST) in the lua prompt), Minecraft version, loader, and relevant mod versions.
• The device type, peripheral layout or network names, and the result you want.
• Existing code and the complete error message, including file and line.
• For production lines: the recipes as they currently work in your pack, and which machine actions the program may take.

Optional companion: cct-run

cct-run is a separate test runtime and MCP server (cct-run mcp). It runs programs on real CC:T code outside Minecraft, emulates core peripherals, and returns scripted responses for mod peripherals, so an agent can check errors, traces, and screens before delivering.

With a compatible cct-live installation and your permission, an agent can also diagnose a chosen in-game computer. The tools are optional: the skill itself installs no mods and connects to no game. See the testing guide for what each kind of test can and cannot prove.

Test evidence

Earlier joint tests shaped the recovery, event, and encoding guidance, but their timings, layouts, permissions, and recipe values do not guarantee performance or compatibility elsewhere. See the mod evidence and the release notes for scope.

Accuracy and validation

• scripts/validate_skill.py compiles every Lua block with Lua 5.2, checks selected core API members against tweaked.cc, and catches global-variable and dot/colon mistakes. Compiling on the host is not full Cobalt compatibility testing.
• The mod guides keep class-file/decompilation evidence, scripted adapter tests, and real game observations apart. A method name in a generated index says nothing about its arguments or whether it exists in a given game.
• The server’s current data and configuration can override bundled recipes and defaults. Discover the actual methods and check the relevant behavior before moving materials.
• GitHub Actions validates the skill and builds the prompt pack on every push and pull request. Static checks and scripted fixtures do not prove game physics, rendering, or every recovery path.

Run validation and packaging with Python and a Lua 5.2 compiler:

python3 scripts/validate_skill.py
python3 scripts/test_validator.py
python3 scripts/package_skill.py

The first validation run caches the official API pages in .cache/; later runs can use --offline. With a compatible cct-run installed, run the examples extracted from the references:

python3 scripts/test_examples.py --cct-run /absolute/path/to/cct-run
python3 scripts/test_mod_examples.py --cct-run /absolute/path/to/cct-run

Acknowledgments

• cc-tweaked/CC-Tweaked and tweaked.cc: the mod and its official documentation.
• dan200/ComputerCraft: the original ComputerCraft.
• SuperFactoryManager_LLM_skill: the model for this repository’s structure.

License

MIT © 2026 EvergardenRoxy

This repository contains guidance, evidence records, and validation scripts. It does not include the CC:T mod itself; CC:T and the other projects mentioned keep their own licenses.