Learned Abilities

generateLearnedAbilities

Evaluates story events for opportunities to grant new abilities. Low priority: most turns produce no output. Use custom to define the world's learnable ability families and acquisition methods.

In the editor

"Learned Abilities Instructions"

Editor location
Files → AI → Advanced → Learned Abilities
Editor type
Edit in Studio + View JSON
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.