my-great-skill
The AGENT-facing description. This is what the model reads to decide WHEN to invoke the skill, so describe the trigger precisely (e.g. "Use this skill whenever the user asks to … BEFORE calling …"). Keep it action-oriented.
Write the agent-facing instructions here as Markdown — this body becomes the
"Instructions" section on the detail page (when there's no README.md) and the
downloadable skill.md. The body loads only after the agent has already
decided to use the skill, so don't restate when to use it here — that belongs
in the frontmatter description. Go straight into how to do the task, in the
imperative (address the agent, not the skill — avoid "You are the … skill").
Instructions
- Concrete, numbered steps the agent should follow.
- ...
Guardrails
- What the agent must not do.
Tone
The voice the agent should adopt.
microsoft/cat-agent-skills · MIT · Revision 4f0fce5a9951
Be the first to comment
Share what worked or leave a question for the creator.