skill:// resources don't trigger on-demand loading based on description matching

[appktor]

Description:

According to the documentation:

│ "Skills are progressively loaded — only metadata (name and description) is loaded at startup, with full content loaded on demand when the agent determines it's
needed."

Expected behavior: Agent sees skill descriptions and loads full content when user query matches.

Actual behavior: Agent never loads skill content automatically. It doesn't appear to see the available skill descriptions.

Evidence:

1. Created a 6.7MB skill with unique, fictional content:
   yaml

---

name: ccsm-zephyr-tc-execution
description: Guide for executing Zephyr test cases in CCSM. Use when user asks about running Zephyr tests, TC execution, test case CCSM-TC-7742, or the Zephyr integration process.

2. Skill contains invented "Golden Sequence" (INIT → PREFLIGHT → EXECUTE → HARVEST → SUBMIT) that the model cannot know.

3. Asked: "How do I execute test case CCSM-TC-7742?"

4. Agent gave generic response, never mentioned the Golden Sequence or any skill content.

5. Context stayed at 2.7% - skill was never loaded.

Environment:

• kiro-cli 1.24.1
• Skill file structure: .kiro/agents//skills//SKILL.md
• Frontmatter with name and description present

Conclusion: The skill:// scheme prevents initial loading (good), but the on-demand loading mechanism doesn't work - the agent has no way to see available skills or
request their content.

[AnilMaktala]

Hey @appktor ,Thank you for reporting this with such detailed information. To help us investigate further, could you please clarify a few things:

• Is this a default skill or a custom skill you created?
• Could you please share your agent configuration file (the .md file in your .kiro/agents directory)?

This information will help us better understand your setup and identify the issue. Thank you!

[wilderdamon]

@appktor Skills work for me - you should see them when running '/context show'. Keep in mind the kiro_default agent does not load skills - this works (for now) when you define a new agent and ensure you have config in the 'resources' section of your agent config that references the skills.

For example in your agent config you need:

"resources": [
"file://AGENTS.md",
"file://README.md",
"skill://.kiro/skills/**/SKILL.md"
],

Ensure you have launched the cli and are using the agent with the correct config.