Description
When using Microsoft Agent Framework Skills, the read_skill_resource tool sometimes receives a resource name without the file extension, even though the Skill references the resource with the full filename.
For example, a Skill references:
references/output-schema.md
But the agent calls:
read_skill_resource(resource_name="references/output-schema")
This causes the resource loading to fail because the actual file name is output-schema.md.
The issue seems related to an inconsistency between the generated Skill instructions and the actual read_skill_resource behavior.
Code Sample
Skill structure:
case-information-extraction/
├── SKILL.md
└── references/
├── extraction-rules.md
└── output-schema.md
SKILL.md:
. Review the output schema and return the result according to it.
Use `references/output-schema.md`
Error Messages / Stack Traces
Error: Resource 'references/output-schema' not found in skill 'case-information-extraction'.
Package Versions
agent-framework 1.9.0
Python Version
3.13.9
Additional Context
The generated system prompt from Agent Framework contains the following instruction:
"Use read_skill_resource to read any referenced resources, using the name exactly as listed
(e.g. "style-guide" not "style-guide.md", "references/FAQ" not "FAQ.md")."
However, the actual read_skill_resource implementation requires the exact resource filename, including the .md extension.
Description
When using Microsoft Agent Framework Skills, the
read_skill_resourcetool sometimes receives a resource name without the file extension, even though the Skill references the resource with the full filename.For example, a Skill references:
references/output-schema.mdBut the agent calls:
read_skill_resource(resource_name="references/output-schema")This causes the resource loading to fail because the actual file name is
output-schema.md.The issue seems related to an inconsistency between the generated Skill instructions and the actual
read_skill_resourcebehavior.Code Sample
Error Messages / Stack Traces
Package Versions
agent-framework 1.9.0
Python Version
3.13.9
Additional Context
The generated system prompt from Agent Framework contains the following instruction:
"Use
read_skill_resourceto read any referenced resources, using the name exactly as listed(e.g.
"style-guide"not"style-guide.md","references/FAQ"not"FAQ.md")."However, the actual
read_skill_resourceimplementation requires the exact resource filename, including the.mdextension.