Skip to content

Skills ​

The skills block automatically calculates your skill modifiers. It pulls from the first abilities block in your file and calculates scores based on those values. Supports proficiency, expertise, half proficiency, and arbitrary bonuses.

INT

Arcana

+7

WIS

Perception

+1

DEX

Stealth

+4

CHA

Deception

+5

DEX

Acrobatics

+2

INT

Investigation

+10

WIS

Insight

+4

INT

History

+5

Example ​

yaml
```skills
proficiencies:
  - arcana
  - deception
  - history
  - insight
  - investigation
  - perception
  - stealth

bonuses:
  - name: Cloak of Elvenkind
    target: stealth
    value: 2

expertise:
  - investigation

half_proficiencies:
  - history
```

The skills block automatically displays all 18 D&D 5e skills: Acrobatics, Animal Handling, Arcana, Athletics, Deception, History, Insight, Intimidation, Investigation, Medicine, Nature, Perception, Performance, Persuasion, Religion, Sleight of Hand, Stealth, and Survival. Only skills listed in proficiencies, expertise, or half_proficiencies receive bonuses — the rest display with their base ability modifier.

Configuration ​

PropertyTypeDefaultDescription
proficienciesArray—List of skills you are proficient in
expertiseArray—List of skills you have expertise in (double proficiency)
half_proficienciesArray—List of skills you have half proficiency in
bonusesArray—List of bonuses to apply to specific skills
advantage †Object—Map of skills to booleans; a true value marks that skill with an up-chevron icon
disadvantage †Object—Map of skills to booleans; a true value marks that skill with a down-chevron icon

† Supports dynamic content templates

Bonus Object ​

PropertyTypeDefaultDescription
nameStringRequiredName of the bonus (for display purposes)
targetStringRequiredWhich skill the bonus applies to
valueNumberRequiredThe bonus value to add

Advantage & Disadvantage ​

Highlight skills that currently have advantage or disadvantage. Keys are skill names matched against the full label, so multi-word skills are written with spaces (sleight of hand). A true value marks the skill with an up-chevron (advantage) or down-chevron (disadvantage) icon; hovering it shows a tooltip naming the skill and which one applies. A skill flagged as both, or as neither, gets no indicator.

yaml
```skills
proficiencies:
  - perception
  - stealth

advantage:
  perception: true
  # Bind the value to frontmatter so a Meta Bind toggle can flip it live
  stealth: "{{frontmatter.stealthAdvantage}}"

disadvantage:
  athletics: "{{frontmatter.athleticsDisadvantage}}"
```

Because the templated values read from frontmatter, a Meta Bind toggle bound to stealthAdvantage (etc.) updates the coloring the moment it changes.