Cursor - Agent Skills in .agents/skills

Support Bug Reports
,
5

Hey, thanks for the report. Before we escalate, we should rule out a couple common causes since this kind of symptom is often config related.

Can you check three things:

  1. File structure. Skills should be placed like .agents/skills/<skill-name>/SKILL.md (it must be SKILL.md inside a subfolder, not just a .md file in the root skills/). Discovery looks for files with that exact name in subdirectories.

  2. Skill frontmatter. Open one SKILL.md and check if it has disable-model-invocation: true. If it does, the skill is intentionally hidden from the model (it shows up in the slash menu and Settings, but it won’t appear in <available_skills>). That was the cause in a similar thread: Why agents can not see my skills in .cursor/skills folder?

  3. Whether the skills show up elsewhere:

  • Cursor Settings (not VS Code settings) > Rules, Skills, Subagents, are your skills listed there?
  • In chat, type /, do they show up in the slash menu?

If they show up in Settings and in the slash menu but not in <available_skills>, this looks like an injection bug. If so, please share the contents of one SKILL.md (remove any secrets) and I’ll file a ticket. If they don’t show up in Settings either, it’s a discovery issue, and we should start by checking the folder structure.