{
  "tab": "ai",
  "section": "generateLearnedAbilities",
  "title": "Learned Abilities",
  "summary": "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.",
  "uiLocation": "AI Tasks → Advanced → Learned Abilities",
  "uiSubtitle": "\"Learned Abilities Instructions\"",
  "editor": "Graphical form (labeled textareas)",
  "sizeLimits": [
    {
      "field": "Each string leaf under a task (`aiInstructions.<task>.<key>`)",
      "limit": "5,000 chars",
      "sections": [
        "ai/aiInstructions",
        "ai/generateStory",
        "ai/generateInitialStart",
        "ai/generateCharacterBackground",
        "ai/generateNPCDetails",
        "ai/generateNPCUpdates",
        "ai/generateLocationDetails",
        "ai/generateRegionDetails",
        "ai/generateFactionDetails",
        "ai/generateEncounters",
        "ai/generateItemGenerationAndUsage",
        "ai/generateActionInfo",
        "ai/generateNPCIntents",
        "ai/generateNewNPC",
        "ai/generateLearnedAbilities"
      ]
    },
    {
      "field": "Per task (`aiInstructions.<task>` total, sum of instruction chars)",
      "limit": "20,000 chars",
      "sections": [
        "ai/aiInstructions",
        "ai/generateStory",
        "ai/generateInitialStart",
        "ai/generateCharacterBackground",
        "ai/generateNPCDetails",
        "ai/generateNPCUpdates",
        "ai/generateLocationDetails",
        "ai/generateRegionDetails",
        "ai/generateFactionDetails",
        "ai/generateEncounters",
        "ai/generateItemGenerationAndUsage",
        "ai/generateActionInfo",
        "ai/generateNPCIntents",
        "ai/generateNewNPC",
        "ai/generateLearnedAbilities"
      ]
    }
  ],
  "related": "abilities - the abilities this task can produce; generateNPCDetails - NPC ability fill-in on first encounter",
  "wikiUrl": "/ai/generateLearnedAbilities",
  "schema": null,
  "body": "## Schema\r\n\r\n```json\r\n{\r\n  \"aiInstructions\": {\r\n    \"generateLearnedAbilities\": {\r\n      \"custom\": \"string\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n\r\n## Example\r\n\r\n```json\r\n{\r\n  \"aiInstructions\": {\r\n    \"generateLearnedAbilities\": {\r\n      \"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.\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n\r\n## Fields\r\n\r\n### custom\r\n\r\nThe only key — free-form rules for what is learnable in this world and how it is acquired.\r\n\r\n## Authoring pattern\r\n\r\nCover in `custom`:\r\n\r\n- What families of abilities exist in this world (magical schools, martial techniques, social arts, crafting trades).\r\n- The rough boundary between learnable and impossible — what the world's logic rules out.\r\n- How abilities are typically acquired: teachers, training arcs, moments of revelation, finding ancient texts."
}