Menú
Decompile and cache TaleWorlds v1.3.15 types via `dots-src path <Type>`. Returns absolute path for grep/cat composition. Use before patching, overriding, or writing adapters.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Author a culture's armor items and swap troop equipment rosters via the generator + validation pipeline. Use when adding/revamping armor. Enforces the canonical-folder + cover-attribute rules.
Give DOTS lords lore-driven skill values and traits via the DOTS SkillSet system. Use when a canonical lord has wrong stats or a culture roster needs a balance pass.
Author or revamp a DOTS culture's armor set, troop tree, and recruitment wiring end-to-end. Use for new cultures or troop-tree revamps. Follows docs/ai-includes/new-culture-authoring.md.
Use when reviewing an external repo or article to adopt practices into DOTS — security-vet first, map novel vs duplicative, port (never install), review, commit your changes.
Structured 4-phase self-debug for failing agent runs (looping, drifting, burning tokens). Capture, diagnose, contained recovery, report. Complements /investigate (which is for code bugs); this skill is for harness/agent failures.
Incrementally fix dotnet build errors with minimal diffs, one error at a time
| name | dots-src |
| description | Decompile and cache TaleWorlds v1.3.15 types via `dots-src path <Type>`. Returns absolute path for grep/cat composition. Use before patching, overriding, or writing adapters. |
Wraps ilspycmd against the installed v1.3.15 DLLs and caches at ~/.dots-src/v1.3.15/. Inspired by vercel-labs/opensrc. Use this before every [HarmonyPatch], GameModel override, or adapter that touches a TaleWorlds type — never guess signatures from the v1.4 dump at E:\Decompiled_Bannerlord\.
# Decompile + cache (first call) or print cached path (subsequent calls)
pwsh tools/dots-src.ps1 path TaleWorlds.CampaignSystem.GameComponents.DefaultPartyWageModel
# Compose with grep/cat/rg — exactly like opensrc
rg "GetCharacterWage" $(pwsh tools/dots-src.ps1 path TaleWorlds.CampaignSystem.GameComponents.DefaultPartyWageModel)
cat $(pwsh tools/dots-src.ps1 path TaleWorlds.MountAndBlade.Formation)
Progress goes to stderr, path goes to stdout — safe in $(...).
| Command | Behavior |
|---|---|
path <Type> | Print absolute path to cached .cs. Decompiles on miss. |
path <Type> -Dll <Name> | Skip namespace heuristic; force a specific DLL. |
list | Show all cached types as a table. --json for raw output. |
remove <Type> | Delete one cache entry. |
clean | Nuke the entire cache. |
~/.dots-src/dll-index.json remembers type → dll from prior lookups. Instant hit.TaleWorlds.CampaignSystem.X.Y probes TaleWorlds.CampaignSystem.X.dll, then TaleWorlds.CampaignSystem.dll, then TaleWorlds.dll. Catches ~99% of cases on the first probe.*.dll in bin/Win64_Shipping_Client alphabetically. ~30 probes max.| Situation | Action |
|---|---|
About to write [HarmonyPatch(typeof(X), nameof(X.Y))] | dots-src path X first — verify Y exists with the expected signature |
About to override GetCharacterWage on DefaultPartyWageModel | dots-src path DefaultPartyWageModel — copy the exact base signature |
| About to call a TaleWorlds API from an adapter | dots-src path <Type> — confirm method exists in v1.3.15 (not just v1.4) |
| Bug investigation: "vanilla does X, what does its code actually look like?" | dots-src path <ClassName> then rg for the symptom |
| Want to know what's already cached | dots-src list |
| Situation | Use instead |
|---|---|
| Looking for a class but don't know the FQN | grep -r "ClassName" E:/Decompiled_Bannerlord/ to find namespace, then dots-src path to verify v1.3.15 |
| Need to browse a whole namespace tree | ls E:/Decompiled_Bannerlord/<area>/ (v1.4 is fine for browsing) |
| Need full type list of a DLL | mcp__ilspy__list_types (the ILSpy MCP is purpose-built for this) |
The recurring failure mode (caught by Codex review 2026-05-06, see feedback_codex_caught_api_misread.md in memory): two agents disagreed on a TaleWorlds API; the more confident one was wrong because it inferred from the v1.4 decompile folder. A single primitive that always lands on v1.3.15 — and caches so the cost is paid once per type — removes the temptation to skip verification.
$env:BANNERLORD_GAME_DIR set to the Bannerlord install root (e.g. E:\Steam\steamapps\common\Mount & Blade II Bannerlord).ilspycmd on PATH (dotnet tool install -g ilspycmd).Both are reported with actionable error messages if missing (per .claude/rules/environment-failures.md).
.claude/skills/research/SKILL.md — broader "decompile and analyze before implementing" workflow. Use that for full analysis sessions; use dots-src for one-shot signature lookups.CLAUDE.md "TaleWorlds Research — Lookup Order" — high-level routing.