Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wow-coach

A Claude Code skill that turns the wowdps damage meter into a live between-pulls World of Warcraft performance coach: it pre-flights the combat-log pipeline over the daemon's MCP server, mines a pasted SimC export for free gear wins, launches patch-current research agents, watches for fight completions in the background, and grades every kill or wipe against a triage rubric with same-spec comparisons and trend tracking.

Install

git clone https://github.com/kriswill/wow-coach
cd wow-coach && ./install.sh

install.sh symlinks wow-coach/ into ~/.claude/skills/ (override the config root with CLAUDE_DIR). Because it's a link, git pull updates the live skill in place. Requires the wowdps daemon's MCP server for the live coaching loop; the SimC-paste and sim-lookup parts work without it.

Layout

  • wow-coach/SKILL.md — the skill entry point: phases, guardrails, and the when-to-load table for everything below.
  • wow-coach/references/ — the coach's working knowledge: MCP tool shapes, the grading rubric, SimC-paste mining, research-agent briefs, gear intelligence, player-verified game facts, and two generated sim lookups (trinket-sims.tsv, secondary-sims.tsv) built from bloodmallet data.
  • wow-coach/scripts/ — pre-flight and MCP helpers, the fight-watch monitor, the bloodmallet fetchers that regenerate the sim lookups, and the talent tooling: render-talents.sh (a self-contained HTML tree viewer with game icons, tooltips, and loadout diffing), loadouts.sh (per-character, per-encounter saved builds under ~/Documents/wow-coach/loadouts/), and fetch-talents-fallback.sh (talent dataset snapshot for machines without a game install).
  • wow-coach/evals/ — trigger evals for the skill description.

Talents

The coach reads and writes the game's own talent import strings through the wowdps MCP server's decode_talents / encode_talents / talent_tree tools, backed by a dataset extracted from the local game files (wowdps' tools/gen-talent-trees.sh, once per patch). Decoded builds are graded per encounter, saved as boss/dungeon/pvp/delve loadouts, and rendered as a graphical tree (scripts/render-talents.sh) the player can read between pulls. See wow-coach/references/talents.md.

Refreshing sim data (once per game patch)

wow-coach/scripts/fetch-trinket-sims.sh      # trinket rankings, ilvl→DPS
wow-coach/scripts/fetch-secondary-sims.sh    # secondary-stat splits at 1/3/5 targets
wow-coach/scripts/fetch-talents-fallback.sh  # talent trees w/o a game install
                                             # (with one: wowdps gen-talent-trees)

Both stamp the sim date and SimC build into the TSV headers; specs missing from the output have no bloodmallet chart for the current game build. Commit the refreshed TSVs so the data is versioned per patch.

License

MIT.

About

Claude Code skill: live WoW performance coaching over the wowdps damage meter's MCP server

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages