Memory, Skills, and Agent not loaded

This page helps troubleshoot issues where project instructions (memory), skills, and Agents are not loaded as expected.

Memory / project instructions not loaded

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

File name: Ensure the file name matches the context.fileName configuration (default AGENTS.md).
Discovery boundary: Upward search stops when it encounters a directory with context.memoryBoundaryMarkers (default .git). Files outside this boundary will not be discovered.
Additional directories: By default, only the current directory is scanned. To load memory from additional trusted directories, enable context.loadMemoryFromIncludeDirectories.
Discovery limit: context.discoveryMaxDirs (default 200) limits the number of directories searched, which may be reached in very large repositories.
Folder Trust: Project content will not be loaded from untrusted directories.
Use /memory to view the currently loaded memory sources.

Use /skills to view the list of loaded skills.
Directory structure: Skills must be located in skills/<name>/SKILL.md. Ensure the directory hierarchy and file names are correct.
Source Priority: The source priority for skills is built-in < plugins < project-level < user-level. When names conflict, higher priority overrides lower priority.
Conditional Skill: Activated only when the file path matches; otherwise, it does not appear.
Feature flag: /skills requires skills support and administrator permissions to be enabled.

Use /agents to view the loaded Agents.
Ensure the Agent definition file location and format are correct (definition files under the agents/ directory).
Check if agents.overrides has disabled the target Agent.
Additional definitions loaded via --agents are valid for this session only.

After modifying definitions, reload by object: use /memory for memory, /skills reload for skills, and /agents reload for Agents; use /commands for custom commands.
If the above methods do not work, restart Qoder CLI; some loading-related configurations are marked as "requires restart" and require a restart after modification.