Skip to content

Memory and skills ​

Workspace memory, Dreams, and how skills load and self-learn. For the concepts, read Memory & Dreams and Skills & Self-Learning.

Memory ​

FieldDescriptionDefault
Memory.EnabledLets new sessions use and maintain workspace memory. Dreams and welcome suggestions also require ittrue
ConsolidationModelModel for Dreams runs. Empty uses the main modelEmpty

Skills ​

FieldDescriptionDefault
Skills.DisabledSkillsSkill names disabled for this workspace. A disabled skill stays on disk but is left out of agent context[]
Skills.IncludeSharedSkillsAlso loads personal skills from ~/.agents/skills, the directory shared with other agent tools. Takes effect on restarttrue
Skills.IncludeBuiltInSkillsDeploys the skills DotCraft ships, such as dotcraft-guide, into the workspace on start. A host that brings its own skills turns this off. Takes effect on restarttrue
Skills.SelfLearning.EnabledMaster switch for agent skill self-learning; off hides skill editing from the modeltrue
Skills.SelfLearning.VariantModeSkill variant write mode: enabled routes self-learning updates to workspace-local skill variants, disabled turns variants offenabled
Skills.SelfLearning.MaxSkillContentCharsMax chars for a single SKILL.md written through self-learning100000
Skills.SelfLearning.MaxSupportingFileBytesMax bytes for a single supporting file written through self-learning1048576

Self-learning example:

json
{
  "Skills": {
    "SelfLearning": {
      "Enabled": true,
      "MaxSkillContentChars": 100000,
      "MaxSupportingFileBytes": 1048576
    }
  }
}

SkillManage(action, ...) reference:

ActionRequired parametersPurpose
createname, contentCreate a new workspace skill
patchname, oldString, newStringLocal patch of SKILL.md or supporting file
editname, contentReplace an existing workspace skill's SKILL.md
write_filename, filePath, fileContentWrite a supporting file
remove_filename, filePathDelete a supporting file

create triggers a kind: skill approval, and destructive deletes require approval too. Self-learning writes only to the current workspace's skill directory. System and personal skills are read-only, supporting files may only live under scripts/ or assets/, and absolute paths or .. traversal are rejected.