encounter-balancer

Evaluate D&D 5e encounter XP budgets against party tier and size.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/giodl73-repo/QUEST --skill encounter-balancer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: encounter-balancer
Source: https://github.com/giodl73-repo/QUEST/tree/main/.claude/skills/encounter-balancer
Command: npx skills add https://github.com/giodl73-repo/QUEST --skill encounter-balancer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Balances D&D 5e encounters by validating XP budgets against party tier and size to ensure fair action economy and meaningful tactical options.

Core Features & Use Cases

  • XP budget validation: computes base XP, applies per-enemy multipliers, and compares to party budget to classify difficulty.
  • Instakill and action-economy checks: flags high-risk threats and assesses swarm vs. solo imbalances.
  • Use Case: during dungeon-smith, validate a Tier 2 encounter and output a balance report to encounters/<slug>-balance.md.
  • Tactical richness and balance reporting: ensures meaningful choices and outputs a structured balance report to encounters/<slug>-balance.md.

Quick Start

Provide the path to an encounter file under encounters/<slug>.md and run the balance check to generate encounters/<slug>-balance.md.

Frequently Asked Questions about encounter-balancer

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

FAQPage Schema
How do I balance D&D 5e encounters using XP budgets?

To balance D&D 5e encounters, this Skill evaluates XP budgets against party tier and size, applying 5e SRD XP multipliers. It then classifies the encounter difficulty and outputs a structured balance report to your encounters folder.

How does action economy validation work for solo monsters versus swarms?

Action economy validation assesses swarm versus solo imbalances by comparing per-enemy XP multipliers against the party budget. This process flags high-risk instakill threats and identifies discrepancies in tactical choices to ensure fair combat.

Can I check a dungeon-smith encounter file for instakill threats?

Yes, you can check a dungeon-smith encounter file for instakill threats by providing the path to encounters/<slug>.md. The Skill reads the target encounter, evaluates high-risk threats, and generates a detailed balance report.

What is the best way to validate a Tier 2 encounter difficulty?

The best way to validate a Tier 2 encounter difficulty is to run an XP budget calculation against the party size. This computes base XP and applies multipliers to accurately classify the challenge rating for your specific group.

Do I need a specific markdown format to generate an encounter balance report?

You need an existing encounter file located at encounters/<slug>.md. The Skill reads this markdown file, runs the balance checks, and outputs the resulting structured YAML header and analysis to encounters/<slug>-balance.md.