wow-addon-structure

Guide structuring World of Warcraft Retail AddOns with .toc metadata and SavedVariables.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill wow-addon-structure-pfchrono
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wow-addon-structure
Source: https://github.com/pfchrono/SimpleUnitFrames/tree/main/.agents/skills/wow-addon-structure
Command: npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill wow-addon-structure-pfchrono

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to structuring World of Warcraft AddOns, ensuring correct file loading, metadata configuration, and data persistence.

Core Features & Use Cases

  • AddOn Structure: Understand folder layouts, naming conventions, and file organization.
  • TOC Metadata: Learn to author and audit .toc files with correct directives.
  • Loading Lifecycle: Reason about file load order, events, and SavedVariables timing.
  • Use Case: Planning a new WoW AddOn? Use this Skill to design the optimal folder structure, create a robust .toc file, and ensure your SavedVariables are loaded correctly.

Quick Start

Use the wow-addon-structure skill to plan the folder layout for a new WoW AddOn.

Frequently Asked Questions about wow-addon-structure

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

FAQPage Schema
How do I structure a World of Warcraft addon folder layout?

Structuring a WoW addon folder layout requires organizing Lua files and subdirectories using specific naming conventions. A correct folder layout ensures the World of Warcraft client properly recognizes and loads your addon files.

What directives do I need to author a WoW addon .toc file?

Authoring a WoW addon .toc file requires specific metadata directives to define load order and dependencies. Correct .toc directives ensure the client loads your addon's Lua files and SavedVariables at the right time.

How does SavedVariables persistence work in WoW addon development?

SavedVariables persistence in WoW addon development works by wiring data to load and save during specific lifecycle events. Correct timing ensures your addon's saved data is available when Lua files execute.

How do I query WoW addon metadata using C_AddOns APIs?

Querying WoW addon metadata uses C_AddOns APIs to retrieve information defined in your .toc file. These Lua APIs allow your scripts to dynamically access load order and configuration details during gameplay.

Why does WoW addon file load order matter for development?

WoW addon file load order matters because Lua files execute sequentially based on .toc definitions. Correct load order ensures dependencies and SavedVariables are available before your addon logic runs.

Can I develop a WoW Retail addon using only Lua and a .toc file?

Developing a WoW Retail addon requires a .toc file for metadata and Lua files for logic. You must configure the .toc directives correctly to manage folder layout, load order, and SavedVariables.