Learned Abilities

generateLearnedAbilities

Creates the new abilities characters learn during play. Use custom for your world's rules on what can be learned and how learned abilities should be named and scoped.

In the editor

"Runs after story events that may justify a new learned ability. Use it to define what counts as a meaningful breakthrough, what ordinary practice should not unlock, and how new abilities should fit the world."

Editor location: Files → AI → Advanced → Learned Abilities
Editor type: Edit in Studio + View JSON
API endpoint: /sections/generateLearnedAbilities.json/sections/generateLearnedAbilities.md
Size limits: Each string leaf under a task (aiInstructions.<task>.<key>) — 5,000

Schema

json

{
  "aiInstructions": {
    "generateLearnedAbilities": {
      "<key>": "string"
    }
  }
}

Example

json

{
  "aiInstructions": {
    "generateLearnedAbilities": {
      "custom": "## Learnable Abilities\nThis world admits four families: arcane spells, martial disciplines, crafting techniques, and social arts. Each requires a teacher, an apprenticeship arc, or a moment of revelation. Avoid raw 'X gains ability Y' jumps."
    }
  }
}

Fields

custom

The only key — free-form rules for what is learnable in this world and how it is acquired.

What this task can award

Every ability it produces is a new one, written for the moment it is earned and attached to that character rather than to the world. It does not hand out an entry from abilities: a proposed name that matches an authored ability, a skill, or an ability the character already holds is treated as a conflict and rejected.

An authored ability reaches a character through its own requirements or through a trait. Gating one on a skill and letting the story teach that skill is what turns a scene into access, since meeting the requirement puts the ability in reach without any trigger. Granting it from a trait is covered under Unlocking one ability from several classes.

Authoring pattern

Cover in custom:

What families of abilities exist in this world (magical schools, martial techniques, social arts, crafting trades).
The rough boundary between learnable and impossible — what the world's logic rules out.
How abilities are typically acquired: teachers, training arcs, moments of revelation, finding ancient texts.

Learned Abilities

#Schema

#Example

#Fields

#custom