{"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.","kind":"schema","uiLocation":"AI Tasks → Advanced → Learned Abilities","uiSubtitle":"\"Learned Abilities Instructions\"","editor":"Graphical form (labeled textareas)","related":[{"section":"abilities","note":"the abilities this task can produce"},{"section":"generateNPCDetails","note":"NPC ability fill-in on first encounter"}],"wikiUrl":"/ai/generateLearnedAbilities","schema":null,"sizeLimits":[{"id":"aiInstructionIndividual","group":"AI Instructions Limits","label":"Each string leaf under a task (`aiInstructions.<task>.<key>`)","measure":"rawChars","enforced":5000,"display":5000,"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"]},{"id":"aiInstructionPerTask","group":"AI Instructions Limits","label":"Per task (`aiInstructions.<task>` total, sum of instruction chars)","measure":"rawChars","enforced":20000,"display":20000,"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"]}],"blocks":[{"type":"example","lang":"json","code":"{\n  \"aiInstructions\": {\n    \"generateLearnedAbilities\": {\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.\"\n    }\n  }\n}"},{"type":"prose","md":"## Fields\n\n### custom\n\nThe only key — free-form rules for what is learnable in this world and how it is acquired."},{"type":"prose","md":"## Authoring pattern\n\nCover in `custom`:\n\n- What families of abilities exist in this world (magical schools, martial techniques, social arts, crafting trades).\n- The rough boundary between learnable and impossible — what the world's logic rules out.\n- How abilities are typically acquired: teachers, training arcs, moments of revelation, finding ancient texts."}],"body":"## Example\n\n```json\n{\n  \"aiInstructions\": {\n    \"generateLearnedAbilities\": {\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.\"\n    }\n  }\n}\n```\n\n## Fields\n\n### custom\n\nThe only key — free-form rules for what is learnable in this world and how it is acquired.\n\n## Authoring pattern\n\nCover in `custom`:\n\n- What families of abilities exist in this world (magical schools, martial techniques, social arts, crafting trades).\n- The rough boundary between learnable and impossible — what the world's logic rules out.\n- How abilities are typically acquired: teachers, training arcs, moments of revelation, finding ancient texts."}