What's the difference between the

AGENTS.md

skill in a repository and the skills in the

.agents/skills

folder in the repository?

I believe these are competing standards. There's a difference in behavior though. IIUC: • AGENTS.md is always loaded into context • skills only have their

description

loaded into context, and the agent decides to open up the skill if it thinks it needs it

I have some silly skills: https://github.com/mamoodi/Test-Repo/tree/main/.agents/skills These don't have descriptions. They both work though.

One of those (maybe both?) are old OH skills with trigger. They are supposed to still work, when the user uses that trigger

So .agents/skill is different than the skill per folder?

I think of it this way: • we support the new format, Agentskills format (with directories and more stuff inside than just one .md file) • we still load the old OH "microagents" -> "skills" (a single .md file with its meaning) and keep compatibility

Okay. Any plans on deprecating the old style or no reason to do that?

I don't know of a reason to deprecate, frankly it seems to me it all works and can work very well. Give or take that I'm not sure we explain it well enough in the docs...

Okay cool. Yeah I don't think the "new" way is even in the docs.

It's here ... -ish https://docs.openhands.dev/sdk/guides/skill#progressive-disclosure-agentskills-standard