Perfect for Gaming Agents needing advanced Skyrim mod configuration capabilities with MCM Helper and Spooky's AutoMod Toolkit. Tools to assist LLMs with creating and editing Skyrim mods.

How do I install skyrim-mcm?

Run the command: npx killer-skills add SpookyPirate/spookys-automod-toolkit/skyrim-mcm. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for skyrim-mcm?

Key use cases include: Generating MCM Helper configuration files, Editing in-game mod settings menus, Creating compatible JSON files for Skyrim mods.

Which IDEs are compatible with skyrim-mcm?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for skyrim-mcm?

Requires Spooky's AutoMod Toolkit. Run commands from the toolkit directory. Compatibility limited to Skyrim MCM Helper.

Skyrim MCM Module

Name: skyrim-mcm
Availability: InStock
Author: SpookyPirate

Create and edit MCM Helper configuration files for in-game mod settings menus using Spooky's AutoMod Toolkit.

Prerequisites

Run all commands from the toolkit directory:

bash
1cd "<TOOLKIT_PATH>"
2# Example: cd "C:\Tools\spookys-automod-toolkit"

Overview

MCM (Mod Configuration Menu) allows mods to have in-game settings menus. This module generates JSON configuration files compatible with MCM Helper.

Command Reference

Create MCM Configuration

bash
1dotnet run --project src/SpookysAutomod.Cli -- mcm create "<modName>" "<displayName>" --output "<file>"

Option	Description
`<modName>`	Internal mod name (no spaces, used for file paths)
`<displayName>`	Display name shown in MCM menu
`--output`, `-o`	Output file path

Get MCM Info

bash
1dotnet run --project src/SpookysAutomod.Cli -- mcm info "<config>"

Validate MCM Configuration

bash
1dotnet run --project src/SpookysAutomod.Cli -- mcm validate "<config>"

Add Toggle (Checkbox)

bash
1dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "<config>" "<id>" "<text>" [options]

Option	Description
`<config>`	Path to config.json
`<id>`	Control identifier (e.g., `bEnabled`)
`<text>`	Display text
`--help-text`	Help text shown on hover
`--page`	Target page name

Add Slider

bash
1dotnet run --project src/SpookysAutomod.Cli -- mcm add-slider "<config>" "<id>" "<text>" --min <n> --max <n> [options]

Option	Default	Description
`<config>`	Required	Path to config.json
`<id>`	Required	Control identifier (e.g., `fDamage`)
`<text>`	Required	Display text
`--min`	0	Minimum value
`--max`	100	Maximum value
`--step`	1	Step increment

Common Workflows

Create Basic Mod Settings

bash
1# 1. Create the MCM config
2dotnet run --project src/SpookysAutomod.Cli -- mcm create "MyMod" "My Awesome Mod" --output "./MCM/config/MyMod/config.json"
3
4# 2. Add an enable toggle
5dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config/MyMod/config.json" "bEnabled" "Enable Mod" --help-text "Turn the mod on or off"
6
7# 3. Add a debug toggle
8dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config/MyMod/config.json" "bDebugMode" "Debug Mode" --help-text "Show debug messages"
9
10# 4. Add a damage multiplier slider
11dotnet run --project src/SpookysAutomod.Cli -- mcm add-slider "./MCM/config/MyMod/config.json" "fDamageMultiplier" "Damage Multiplier" --min 0.5 --max 3.0 --step 0.1
12
13# 5. Validate the configuration
14dotnet run --project src/SpookysAutomod.Cli -- mcm validate "./MCM/config/MyMod/config.json"

Create Multi-Page Settings

bash
1# Create config
2dotnet run --project src/SpookysAutomod.Cli -- mcm create "MyMod" "My Mod" --output "./MCM/config.json"
3
4# Add controls to "General" page (default)
5dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config.json" "bEnabled" "Enable Mod"
6
7# Add controls to "Combat" page
8dotnet run --project src/SpookysAutomod.Cli -- mcm add-slider "./MCM/config.json" "fDamage" "Damage Bonus" --min 0 --max 100 --page "Combat"
9dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config.json" "bCritical" "Enable Criticals" --page "Combat"
10
11# Add controls to "Magic" page
12dotnet run --project src/SpookysAutomod.Cli -- mcm add-slider "./MCM/config.json" "fSpellCost" "Spell Cost Reduction" --min 0 --max 50 --page "Magic"

Validate and Check Existing MCM

bash
1# Check MCM structure
2dotnet run --project src/SpookysAutomod.Cli -- mcm info "./MCM/config/SomeMod/config.json"
3
4# Validate for errors
5dotnet run --project src/SpookysAutomod.Cli -- mcm validate "./MCM/config/SomeMod/config.json"

MCM Helper Integration

Required File Structure

MCM Helper expects files in specific locations:

Data/
  MCM/
    config/
      MyMod/
        config.json     # Main config (required)
        settings.ini    # Default values (optional)
    translations/
      MyMod_english.txt # Translations (optional)

Config JSON Format

Generated config.json structure:

json
1{
2  "modName": "MyMod",
3  "displayName": "My Awesome Mod",
4  "minMcmVersion": 7,
5  "pages": [
6    {
7      "pageDisplayName": "Main",
8      "content": [
9        {
10          "type": "toggle",
11          "id": "bEnabled",
12          "text": "Enable Mod"
13        },
14        {
15          "type": "slider",
16          "id": "fDamage",
17          "text": "Damage Multiplier",
18          "min": 0.5,
19          "max": 2.0,
20          "step": 0.1
21        }
22      ]
23    }
24  ]
25}

Control Types

Type	Description	Properties
toggle	Checkbox	id, text, help
slider	Value slider	id, text, min, max, step
dropdown	Dropdown list	id, text, options
keymap	Key binding	id, text
text	Text input	id, text

Linking MCM to Scripts

MCM values are stored as GlobalVariables in your plugin:

papyrus
1ScriptName MyMod_ConfigScript extends Quest
2
3; These must match the MCM control IDs
4GlobalVariable Property bEnabled Auto
5GlobalVariable Property fDamageMultiplier Auto
6
7Function ApplySettings()
8    If bEnabled.GetValue() == 1
9        float damage = fDamageMultiplier.GetValue()
10        ; Apply settings...
11    EndIf
12EndFunction

Naming Conventions

Control IDs

Follow Hungarian notation for clarity:

bSomething - Boolean toggles
fSomething - Float sliders
iSomething - Integer values
sSomething - String values

Examples

bEnabled - Main enable toggle
bDebugMode - Debug mode toggle
fDamageMultiplier - Damage multiplier (float)
iItemCount - Item count (integer)
fSpellCostReduction - Spell cost reduction percentage

Important Notes

MCM Helper required - Users must have MCM Helper installed
GlobalVariables must exist - Create matching globals in your plugin
File location matters - Place config in Data/MCM/config/ModName/
Validate before release - Always run validate command
Use --json flag for machine-readable output when scripting

Complete MCM + Plugin Workflow (Basic)

bash
1# 1. Create the plugin
2dotnet run --project src/SpookysAutomod.Cli -- esp create "MyConfigMod.esp" --light
3
4# 2. Add globals that match MCM controls
5dotnet run --project src/SpookysAutomod.Cli -- esp add-global "MyConfigMod.esp" "bEnabled" --type long --value 1
6dotnet run --project src/SpookysAutomod.Cli -- esp add-global "MyConfigMod.esp" "fDamageMultiplier" --type float --value 1.0
7
8# 3. Create MCM config
9dotnet run --project src/SpookysAutomod.Cli -- mcm create "MyConfigMod" "My Config Mod" --output "./MCM/config/MyConfigMod/config.json"
10
11# 4. Add matching controls
12dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config/MyConfigMod/config.json" "bEnabled" "Enable Mod"
13dotnet run --project src/SpookysAutomod.Cli -- mcm add-slider "./MCM/config/MyConfigMod/config.json" "fDamageMultiplier" "Damage Multiplier" --min 0.5 --max 2.0 --step 0.1
14
15# 5. Validate
16dotnet run --project src/SpookysAutomod.Cli -- mcm validate "./MCM/config/MyConfigMod/config.json"

Complete MCM + Script Workflow with Auto-Fill

bash
1# 1. Create the plugin and quest
2dotnet run --project src/SpookysAutomod.Cli -- esp create "MyConfigMod.esp" --light
3dotnet run --project src/SpookysAutomod.Cli -- esp add-quest "MyConfigMod.esp" "MyConfigQuest" --start-enabled
4
5# 2. Add globals that match MCM controls
6dotnet run --project src/SpookysAutomod.Cli -- esp add-global "MyConfigMod.esp" "bEnabled" --type long --value 1
7dotnet run --project src/SpookysAutomod.Cli -- esp add-global "MyConfigMod.esp" "fDamageMultiplier" --type float --value 1.0
8dotnet run --project src/SpookysAutomod.Cli -- esp add-global "MyConfigMod.esp" "bDebugMode" --type long --value 0
9
10# 3. Create script that references these globals
11cat > "./Scripts/Source/MyConfigScript.psc" << 'EOF'
12ScriptName MyConfigScript extends Quest
13
14GlobalVariable Property bEnabled Auto
15GlobalVariable Property fDamageMultiplier Auto
16GlobalVariable Property bDebugMode Auto
17
18Event OnInit()
19    RegisterForSingleUpdate(1.0)
20EndEvent
21
22Event OnUpdate()
23    If bEnabled.GetValue() == 1
24        float mult = fDamageMultiplier.GetValue()
25        If bDebugMode.GetValue() == 1
26            Debug.Notification("Damage multiplier: " + mult)
27        EndIf
28    EndIf
29    RegisterForSingleUpdate(5.0)
30EndEvent
31EOF
32
33# 4. Compile script
34dotnet run --project src/SpookysAutomod.Cli -- papyrus compile "./Scripts/Source/MyConfigScript.psc" --output "./Scripts" --headers "./skyrim-script-headers"
35
36# 5. Attach script to quest
37dotnet run --project src/SpookysAutomod.Cli -- esp attach-script "MyConfigMod.esp" --quest "MyConfigQuest" --script "MyConfigScript"
38
39# 6. Auto-fill script properties from PSC (links globals automatically!)
40dotnet run --project src/SpookysAutomod.Cli -- esp auto-fill "MyConfigMod.esp" --quest "MyConfigQuest" --script "MyConfigScript" --psc-file "./Scripts/Source/MyConfigScript.psc" --data-folder "C:/Skyrim/Data"
41
42# Output:
43# Filled property 'bEnabled' with MyConfigMod.esp:0x000800
44# Filled property 'fDamageMultiplier' with MyConfigMod.esp:0x000801
45# Filled property 'bDebugMode' with MyConfigMod.esp:0x000802
46
47# 7. Create MCM config
48dotnet run --project src/SpookysAutomod.Cli -- mcm create "MyConfigMod" "My Config Mod" --output "./MCM/config/MyConfigMod/config.json"
49
50# 8. Add matching MCM controls
51dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config/MyConfigMod/config.json" "bEnabled" "Enable Mod"
52dotnet run --project src/SpookysAutomod.Cli -- mcm add-slider "./MCM/config/MyConfigMod/config.json" "fDamageMultiplier" "Damage Multiplier" --min 0.5 --max 2.0 --step 0.1
53dotnet run --project src/SpookysAutomod.Cli -- mcm add-toggle "./MCM/config/MyConfigMod/config.json" "bDebugMode" "Debug Mode"
54
55# 9. Validate MCM
56dotnet run --project src/SpookysAutomod.Cli -- mcm validate "./MCM/config/MyConfigMod/config.json"
57
58# 10. Generate SEQ file (required for start-enabled quest)
59dotnet run --project src/SpookysAutomod.Cli -- esp generate-seq "MyConfigMod.esp" --output "./SEQ"

Why This Workflow Matters:

Auto-fill automatically links the GlobalVariable properties in your script to the actual globals in your plugin
No manual property filling in Creation Kit required
Type-safe matching ensures correct globals are linked
Works with your own plugin's globals, not just vanilla Skyrim records

JSON Output

All commands support --json for structured output:

bash
1dotnet run --project src/SpookysAutomod.Cli -- mcm info "./config.json" --json

skyrim-mcm — community skyrim-mcm, spookys-automod-toolkit, community, ide skills, Claude Code, Cursor, Windsurf

About this Skill

Agent Capability Analysis

Ideal Agent Persona

Core Value

↓ Capabilities Granted for skyrim-mcm

! Prerequisites & Limits

Browser Sandbox Environment

⚡️ Ready to unleash?

skyrim-mcm