agentleFS
JBurlisonJBurlison/WoWAddonAPIAgents/skills/wow-client-targets/SKILL.md

wow-client-targets

Skill75 starsChanged 13 days agoMITView on GitHub

Resolve Retail, Forever, and Classic progression targets and verify version-specific WoW API evidence. Use before addon API lookup, client detection, compatibility decisions, TOC generation, or porting between WoW versions.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If access fails, state that the latest version could not be checked.

    line 30

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Client targets and source evidence

TargetBranch in Gethe/wow-ui-sourceMeaning
retailliveCurrent Retail
foreverforeverForever; not Classic Era
classicclassicCurrent Classic progression

all expands to these three only. Explicit targets override inferred configuration. Use the existing addon's documented targets, TOCs, and release configuration when the request omits targets; ask if these conflict or are inconclusive. Do not identify a client solely from a namespace name, a shared project constant, or one TOC interface value.

Snapshot and current sources

targets.json records source-inventory snapshots, not certification of every API. Interface numbers are derived from version.txt and must be confirmed against the target client's select(4, GetBuildInfo()) before release. A source mirror may lead or lag an installed client; honor an explicitly requested build.

With Node.js 22+, optionally run node <this-skill>/scripts/targets.mjs retail forever (or all) to print bundled metadata. No Node dependency is required to read the skills or perform source lookups using the host's tools.

For current evidence:

  1. Resolve https://api.github.com/repos/Gethe/wow-ui-source/commits/<branch> and capture the full SHA. Do not mix moving branch content with pinned evidence.
  2. Inspect version.txt and the tree at that SHA. Start with Interface/AddOns/Blizzard_APIDocumentationGenerated, then follow the UI addon's TOC/XML includes and client-specific files. Check shared versus game-specific loading conditions.
  3. For each needed capability, use the evidence record: target, commit, source path, contract, loading and restrictions, with source declaration, runtime observation and operation testing recorded separately. Missing generated documentation alone means unknown, not removed.
  4. Trace the loaded constants before implementing runtime detection. The same tree may contain Mainline, Vanilla, Mists, and other constants with different WOW_PROJECT_ID assignments. Do not invent a Forever project ID. When detection cannot uniquely distinguish clients, use per-target packaged configuration plus runtime build validation.
  5. Consult COMPATIBILITY.md, then the specific domain skill. Scope every deprecation and restriction to the target/build where it was verified.

If access fails, state that the latest version could not be checked. Use dated bundled evidence only where sufficient; flag unresolved features and do not advance snapshot metadata. A successful function-existence probe does not establish matching semantics or permission to inspect returned values.

For Forever detection, beta defect history and current source boundaries, read Forever build evidence. For a fresh runtime comparison, follow the capture and validation procedure.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.