Luban Config Skill — AI skill for Claude Code

Luban Config Skill

[English](#english) | [中文说明](#chinese)

**Empower your AI Agents to safely query and edit Luban-format Game Configuration Tables.**

**让你的 AI Agent 安全、精准地读写 Luban 格式的游戏配置表。**

---

🇬🇧 English Description

📖 Introduction

**Luban Config Skill** is a specialized **Agent Skill** designed for LLMs (Claude, Gemini, ChatGPT/Copilot). It allows AI agents to perform surgical operations—**Query, Update, Insert, Delete**—on Excel files that follow the [Luban](https://github.com/focus-creative-games/luban) format (`##var`, `##type`).

Instead of feeding the entire Excel file to the LLM (which consumes tokens and risks hallucinations), this tool adopts a **"Query → Patch"** architecture. The AI queries only what it needs and generates a JSON patch to apply changes.

🚀 Why Use This?

• Token Efficiency: Stop reading 10,000 rows. Use limit, offset, and columns to fetch only relevant data.
• Structure Safety: Direct Excel editing by LLMs often breaks formatting. This tool uses a strict schema-aware script to handle edits.
• Complex Type Support: Native handling of Luban types like map,int,string, array,int, and custom separators (e.g., (map#sep=|)).
• Safety First: Supports dry_run to preview diffs and implements "Soft Delete" (marking rows as #DELETED#) instead of physical removal.

✨ Key Features

• Luban Native: Automatically recognizes ##var and ##type rows. Validates data types before writing.
• Multi-Platform Installer: Supports Claude Code, Gemini CLI, and GitHub Copilot/Codex.
• Atomic Patching: Modifications are applied via a standardized JSON Patch format.
• Diff Preview: Generate human-readable diffs ("active: True -> False") before saving changes.

🛠 Installation

Option 1: Automatic Script (CLI / Developers)

Use the `install.sh` script to set up the skill for your command-line environment or project.

# Make script execut