Memory, Skills, and Agents Not Loading

This page helps you diagnose issues where project instructions (memory), Skills, or Agents are not loaded as expected.

Memory / project instructions not loaded

When the project instructions file (default AGENTS.md) is not loaded into context:

File name: confirm the file name matches the context.fileName setting (default AGENTS.md).
Discovery boundary: the upward search stops at a directory containing context.memoryBoundaryMarkers (default .git). Files outside the boundary are not discovered.
Additional directories: only the current directory is scanned by default. To load memory from additional trusted directories, enable context.loadMemoryFromIncludeDirectories.
Discovery limit: context.discoveryMaxDirs (default 200) caps the number of searched directories; very large repositories may hit the limit.
Folder trust: untrusted directories do not load project content.
Use /memory to view the currently loaded memory sources.

Use /skills to view the list of loaded Skills.
Directory structure: a Skill must live at skills/<name>/SKILL.md. Confirm the directory hierarchy and file name are correct.
Source priority: Skill sources rank built-in < plugin < project level < user level; on name conflicts, higher priority overrides lower.
Conditional Skills: activated only when file paths match; they do not appear otherwise.
Feature switch: /skills requires Skills support and the admin toggle to be enabled.

Use /agents to view loaded Agents.
Confirm the Agent definition files are in the right location and format (definition files under the agents/ directory).
Check whether agents.overrides disables the target Agent.
Extra definitions loaded via --agents apply to the current session only.

After editing a definition, reload per object: /memory for memory, /skills reload for Skills, /agents reload for Agents; /commands for custom commands.
If none of those work, restart Qoder CLI CN; some loading-related settings are marked "restart required" and only apply after a restart.