🚜 FS25 Claude Skill — AI-Powered Mod Development Assistant

"The first definitive Claude skill built specifically for Farming Simulator 25 mod development."
Supercharge your FS25 modding workflow with AI that actually knows the APIs, patterns, and pitfalls.

---

🎩 Meet the Experts

When you use this skill, you aren't just talking to a generic AI. You're working with a specialized team:

• Claude (Senior Software Engineer): 🎩 Focuses on technical mandates, Lua 5.1 sandboxing, and high-performance patterns. He ensures your code won't crash the Giants Engine.
• Samantha (Project Manager): 🚀 Keeps your mod project on track, manages repo structure, and ensures you're following the best community standards.

---

📖 What Is This?

This is a Claude Skill — a modular, self-contained knowledge package that transforms Claude into an expert FS25 developer. It replaces "AI hallucinations" with battle-tested facts.

The Knowledge Base At A Glance

Resource	Content	Coverage
LUADOC	1,661 Documentation Pages	11,102+ Script Functions — fetched live via WebFetch
Source	267 Giants Lua Files	Internal Engine Implementation — fetched live via WebFetch
Patterns	30+ Validated Templates	GUI, Events, Save/Load, Vehicles, HUD, Field Detection
Pitfalls	20+ Critical "Crash Traps"	os.time(), DialogElement, goto, hook accumulation, mouseEvent

---

🎬 Quick Demo

Ask Claude (or me!) anything about FS25 modding:

🎩 "Claude, I need a multiplayer-safe event that syncs a custom 'damageLevel' variable."
🚀 "Samantha, what's the correct directory structure for a vehicle specialization mod?"
🚜 "How do I create a custom Yes/No dialog that actually works in FS25?"
🌾 "What field is the player currently standing in, and how do I detect it reliably?"

---

🔧 Technical Mandates (The "Ground Truth")

This skill enforces strict adherence to FS25's unique environment:

1. Sandboxed Lua 5.1: No os.time(), no goto, no table.pack().
2. Bottom-Left Origin: GUI coordinates (0,0) are at the bottom-left, not top-left.
3. Manager Safety: Always nil-check g_financeManager, g_server, and g_client.
4. Base Classes: Use MessageDialog, NOT DialogElement (it causes white-box rendering crashes).
5. Hook Cleanup: Always restore appendedFunction hooks on mod unload — they stack on savegame reload.

---

📦 Installation & Setup

1. Download

Grab the latest .skill file from the Releases page.

2. Location

Place the fs25-modding-skill.skill file in your Claude skills folder:

• Windows: %APPDATA%\Claude\skills\
• Mac/Linux: ~/.claude/skills/
• Project-level: Drop it in your mod project root

3. Activate

Restart your Claude session. The skill activates automatically whenever you mention "FS25", "Farming Simulator", paste Lua mod code, or reference Giants Engine APIs.

---

📚 Deep Dive: Knowledge Sources

This skill stands on the shoulders of the community's hardest workers:

1. FS25 Community LUADOC

Provided by @umbraprior. Complete API coverage from Engine to Script.

• 1,661 pages · 11,102+ documented functions
• How it works: The skill indexes all paths locally; Claude uses WebFetch to retrieve full docs on demand — no local install required.
• Repo: umbraprior/FS25-Community-LUADOC

2. FS25 Lua Scripting (Source Archive)

Provided by @Dukefarming. The actual Giants source code (dataS) for reference.

• 267 Lua files — understand how Giants implements things internally
• How it works: Same WebFetch-on-demand pattern as the LUADOC.
• Repo: Dukefarming/FS25-lua-scripting

3. FS25 AI Coding Reference (Patterns)

Provided by @XelaNull (FS25_UsedPlus). Battle-tested patterns validated against an 83-file production mod with 30+ custom dialogs.

• Bundled directly in the skill — works offline, no fetching needed.
• Repo: XelaNull/FS25_UsedPlus/FS25_AI_Coding_Reference

---

🗺️ Roadmap & Community

We're building this together. Join the effort!

• v1.0.0 — Initial release with full 3-way knowledge integration
• v1.1.0 — WebFetch live lookups (LUADOC + source, no local files needed), field detection pattern, 3 new pitfalls, proper attribution
• v1.2.0 — modDesc.xml schema validation helpers
• v1.3.0 — Top 20 community mods indexed as pattern sources
• v2.0.0 — Specialized sub-skills (e.g., "The GUI Expert", "The Vehicle Architect")

Contributing

Found a new pitfall? Have a pattern that's better than ours? 🎩 Claude and 🚀 Samantha love pull requests! See CONTRIBUTING.md.

---

📄 License

MIT License. Bundled community documentation retains its original licenses from the respective creators. See LICENSE for details.

---

Made with 🚜 for the FS25 modding community

Senior Engineer: Claude · Project Manager: Samantha