Skip to content

Classes Folder

Purpose

Documentation for Path of Exile's seven character classes and their ascendancy specializations.

Naming Conventions

File Names

  • Format: [class-name].md (kebab-case, lowercase)
  • Use the official class name

Examples:

  • duelist.md
  • witch.md
  • marauder.md
  • ranger.md
  • shadow.md
  • templar.md
  • scion.md

Template Requirements

Template: templates/class-template.md

Required Frontmatter:

yaml
template: "templates/class-template.md"
document_type: "class"
title: "[Class Name]"
class_type: "Pure Strength|Pure Dexterity|Pure Intelligence|Str/Dex Hybrid|Str/Int Hybrid|Dex/Int Hybrid|All Attributes"
status: "draft|review|published|outdated"
author: "[Your Name]"
created: "YYYY-MM-DD"
updated: "YYYY-MM-DD"
tags: ["class", "character", "[attribute-combo]"]
league: "3.25"
patch: "3.25.1"
wiki_source: "https://www.poewiki.net/wiki/[Class_Name]"

Content Guidelines

What to Include

  • Class Overview - Core identity and playstyle
  • Base Stats - Starting attributes (Str/Dex/Int)
  • Ascendancy Classes - All three ascendancy options with descriptions
  • Starting Location - Position on passive tree
  • Equipment Affinities - Preferred armor and weapon types
  • Lore Background - Character backstory and exile reason
  • Strengths & Weaknesses - What the class excels at and struggles with

Tags

yaml
tags:
  - "class"
  - "character"
  - "str" | "dex" | "int" | "str-dex" | "str-int" | "dex-int"

Path Conventions

Always use absolute paths from project root:

CORRECT:

yaml
relationships:
  related_builds:
    - path: "builds/duelist/rf-juggernaut.md"
      title: "RF Juggernaut"

INCORRECT:

yaml
relationships:
  related_builds:
    - path: "../../builds/duelist/rf-juggernant.md"

Quality Checklist

Before creating a class document:

  • [ ] Read this index.md
  • [ ] Read templates/class-template.md
  • [ ] Used correct naming convention (lowercase, kebab-case)
  • [ ] Included template: field in frontmatter
  • [ ] Set document_type: "class"
  • [ ] Set class_type to appropriate value
  • [ ] Added "class" and "character" tags
  • [ ] Included attribute tag (str, dex, int, or hybrid)
  • [ ] Set current league and patch version
  • [ ] Used absolute paths for relationships
  • [ ] Set appropriate status
  • [ ] Added wiki source URL

Examples

Good File Names

  • duelist.md
  • witch.md
  • shadow.md

Bad File Names

  • Duelist.md (capitalized)
  • the-duelist.md (no "the" prefix)
  • duel.md (abbreviated)

Last Updated: 2025-11-04

poe-aio - Path of Exile All-in-One