pc-combat-primer

Generates quantitative PC and party combat profiles for D&D 5e encounter calibration.

Updated May 29, 2026
One-click install
npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill pc-combat-primer-thedougler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pc-combat-primer
Source: https://github.com/Thedougler/shattered-sea-wiki/tree/main/.claude/skills/pc-combat-primer
Command: npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill pc-combat-primer-thedougler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Generic CR tables in D&D 5e do not reflect how a specific party actually performs at the table. This Skill replaces guesswork with empirical combat intelligence by building per-PC and party-wide combat profiles from character sheets and real session data, so encounter difficulty is calibrated to observed dice rolls, damage, and tactics rather than assumptions. ## Core Features & Use Cases - PC Combat Profiles: Creates per-character documents with theoretical sustained/nova DPR, effective HP, defensive thresholds, resource economy, counter profiles, and an append-only session combat log. - Party Combat Profile: Compiles individual profiles into combined DPR, synergy matrices, weakness maps, and an empirically derived Effective CR Band that the prep-encounter skill reads for difficulty calibration. - Character Sheet Conversion: Converts PDF character sheets into canonical agent-readable markdown at wiki/system/players/{pc-slug}-sheet.md. - Use Case: After a session with combat is ingested, run this Skill to append observed damage and hit-rate data to each PC's profile, recalculate observed averages, and flag the party profile for recompilation before the next encounter is designed. ## Quick Start Update the combat profiles for all PCs using the combat data from session 4 and recompile the party combat profile.

Frequently Asked Questions about pc-combat-primer

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

FAQPage Schema
How do I calculate a D&D 5e character's sustained DPR?▼

Sustained DPR is calculated by multiplying each attack's hit chance against a target AC by its average damage, then summing across all attacks in a round. This Skill computes it against AC 13, 15, 17, and 19 and records the math inline with a [calculated] source tag.

How do I calibrate encounter difficulty beyond CR in D&D 5e?▼

Start with standard 5e XP thresholds, then adjust based on observed session data: raise the floor if the party trivializes encounters, lower the ceiling after near-TPKs, and factor in party-specific traits like missing AoE or strong focus-fire. Bands from fewer than 3 encounters are marked low confidence.

Can I use a PDF character sheet to build a combat profile?▼

Yes. The Skill reads the PDF directly and converts it into a structured markdown sheet at wiki/system/players/{pc-slug}-sheet.md following the CHARACTER-SHEET-CONVERSION reference. The markdown becomes the canonical mechanical source for all downstream calculations.

What data is extracted from session transcripts for combat profiles?▼

Per PC and per encounter: rounds active, damage dealt and taken, hits versus attacks, saves, resources spent, and key tactical moments. Uncertain values are marked with ~ or [unknown]; invented numbers are prohibited, and zero-damage rounds are recorded as valid data.

When should the party combat profile be recompiled?▼

Recompile whenever any PC profile has been updated more recently than the party profile's last_compiled date. Typical triggers include level-ups, new session combat data, significant gear changes, or a PC profile update flagged by the session-ingest handoff.