balatro-mod-dev

Create and debug Balatro mods with Lua and SMODS API references.

3|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/liafonx/Open-Balatro --skill balatro-mod-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: balatro-mod-dev
Source: https://github.com/liafonx/Open-Balatro/tree/main/skills/balatro-mod-dev
Command: npx skills add https://github.com/liafonx/Open-Balatro --skill balatro-mod-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the complex process of developing mods for the game Balatro, providing AI agents with the necessary tools, references, and workflows to create, debug, and maintain mods efficiently.

Core Features & Use Cases

  • Guided Development: Provides AI agents with structured documentation, patterns, and best practices for Balatro modding.
  • Automated Setup: Offers scripts and templates for initializing new mods and configuring development environments.
  • Debugging Assistance: Includes tools and references for diagnosing and fixing common modding issues.
  • Use Case: An AI agent can use this Skill to understand Balatro's game source, learn SMODS API usage, write Lua code for new features, and automatically sync changes to the game's mod directory.

Quick Start

Use the balatro-mod-dev skill to help me initialize a new Balatro mod project.

Frequently Asked Questions about balatro-mod-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I develop Balatro mods using Lua with AI assistance?

Balatro mod development with AI assistance involves providing an AI agent with structured documentation, SMODS API patterns, and utility scripts for writing and debugging Lua code. This workflow integrates with Steamodded, Lovely, and game source references to support automated setup and code generation.

What is the best way to set up a Steamodded development environment for Balatro?

The best way to set up a Steamodded development environment is using automated setup scripts and templates that initialize new mod projects and configure the directory structure. This process provides AI agents with the necessary utility scripts and references to manage the environment efficiently.

Can I use AI to debug and fix common Balatro modding issues?

Yes, you can use AI to debug Balatro modding issues by providing the agent with dedicated tools and references for diagnosing common problems. The debugging workflow includes game source references and code patterns to help identify and fix errors in your Lua mod logic.

Does Balatro mod development require knowledge of the SMODS API and Lovely framework?

Balatro mod development requires understanding the SMODS API and Lovely framework to implement new features correctly. The provided references and structured documentation help AI agents learn the API usage, game source structure, and best practices to write functional Lua code.

Why is my Balatro mod not loading after syncing changes to the mod directory?

If your Balatro mod is not loading after syncing changes, the issue often stems from incorrect SMODS API usage or Lua syntax errors. Using the included debugging assistance and game source references helps diagnose structural problems, verify code patterns, and resolve common modding conflicts.